market

Market History

Bulk history for one coin, one metric per call, in pages: 'price' (OHLCV candles, spot or perp), 'open_interest' (market-wide aggregate USD), 'funding' (OI-weighted rate, %/8h and annualized) or 'liquidations' (market-wide long/short USD per bucket). Returns up to 'limit' rows (default 200, max 1000) at or before 'end' (default now), oldest first, as compact columns + rows; pass the returned nextEndMs as 'end' to fetch the page before it, and 'start' to stop there. Reach: price is full venue history (Binance spot from 2017, futures from 2019) at 1m–1w; derivatives come from CoinGlass at 4h (about 180 days back), 6h/8h/12h (about 360 days) or 1d/1w (back to 2020) — use 1d for anything older than six months. The newest row may still be forming (newestForming). Use this to pull history; for a read of what is happening now, use the derivatives_* and research_* tools.

get/market/history/{symbol}

Request

  • Base URL: https://mcp.f1ow.com/v1
  • URL: https://mcp.f1ow.com/v1/market/history/{symbol}
  • Auth: one of:
    • HTTP bearer
    • none

Path parameters

symbolstring required

Coin symbol, e.g. "BTC".

Query parameters

metric'price' | 'open_interest' | 'funding' | 'liquidations' required
interval'1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '6h' | '8h' | '12h' | '1d' | '1w'

Bucket size. Price: 1m–1w except 6h/8h, default 1d. Derivatives: 4h, 6h, 8h, 12h, 1d or 1w; default 4h (funding 8h).

market'spot' | 'perp'

Price only: spot (default) or perpetual candles.

startstring

Earliest time to include: ISO-8601 (UTC if no offset) or Unix ms. Paging stops here.

endstring

Latest time to include: ISO-8601 or Unix ms. Default now. Pass nextEndMs here to page back.

limitinteger

Rows per page, 1–1000. Default 200.

Response

The result.

textstring required

Human-readable rendering of the result.

Changes

No recorded changes to this operation across all 1 revision of this API.