market

Price Candles

OHLC(V) candle history for a coin by symbol (e.g. 'ETH', 'BTC'). 'interval' picks the candle size (1m|5m|15m|30m|1h|4h|12h|1d|1w, default 1d); 'limit' the number of candles (default 100, max 400); 'market' picks the series — 'spot' (Binance, Bybit, then CoinGecko/CoinMarketCap), 'perp' (Hyperliquid, Bybit, then Binance futures — perpetual marks), or 'auto' (default: spot preferred; perp when spot fails, or when spot's history is shorter than the request and than 210 candles while perp's is materially longer — e.g. a coin whose spot pair listed recently). spot/perp are hard constraints and error rather than substitute. The response labels the market, interval and source actually delivered, includes USD volume when the source carries it, and flags a still-forming last candle.

get/market/candles/{symbol}

Request

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

Path parameters

symbolstring required

Coin symbol, e.g. 'ETH' or 'BTC'

Query parameters

interval'1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '12h' | '1d' | '1w'

Candle size. Default 1d.

market'spot' | 'perp' | 'auto'

Which market's series: spot exchange trades, perpetual-futures marks, or auto (spot preferred; perp when spot fails or its history is too short). Default auto.

limitinteger

Number of candles, newest last. Default 100, max 400.

daysinteger

DEPRECATED: trailing window in days; use interval+limit instead. Ignored when interval is given.

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.