ASasksurf
Exchange

Exchange Historical Candles

Returns persisted OHLCV candles for a covered Bithumb, Upbit, HashKey, bitFlyer, Coinone, or Korbit spot market.

Intervals: 5m, 4h, and 1w. bitFlyer is currently reliable for weekly (1w) OHLCV only.

Pagination: use from/to to bound the time range and limit to cap returned candles. Results are ordered newest first.

Synthetic candles: include_synthetic=true by default, so carry-forward candles for no-trade intervals are included for continuous charts. Set include_synthetic=false for raw exchange-only candles. Sparse Korbit markets may rely on synthetic rows to keep charts continuous.

get/gateway/v1/exchange/candles

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

exchange'bithumb' | 'upbit' | 'hashkey' | 'bitflyer' | 'coinone' | 'korbit' required

Exchange identifier

Example:bithumb
pairstring required

Trading pair in base/quote form, e.g. BTC/KRW

Example:BTC/KRW
interval'5m' | '4h' | '1w'

Candle interval

Example:5m
fromstring

Start of time range. Accepts Unix seconds or date string

Example:2026-06-24T09:00:00Z
tostring

End of time range. Accepts Unix seconds or date string

Example:2026-06-24T10:00:00Z
include_syntheticboolean

Whether to include carry-forward candles for no-trade intervals. Defaults to true for continuous charts; set false for raw exchange-only candles.

Example:true
limitinteger

Max number of candles to return. Weekly candles allow up to 300 rows for a 5-year chart; intraday intervals are capped at 100.

Example:100
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseExchangeCandleItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.