Skip to main content

Get candle history

GET 
/v1/market-data/accounts/:account_id/candles

Returns historical candles for the selected instrument and timeframe.

Note: Candle history is available for:

  • ask
  • bid
  • both ask and bid

Rules:

  • 'from' is required
  • use either:
    • from + count
    • or from + to
  • 'from' must be earlier than to
  • 'count' is bidirectional and its absolute value must not exceed the configured candle limit
  • if 'to' is used, the requested range must not exceed the configured candle limit
  • retrieve the current limit from GET /v1/configuration/accounts/{account_id}/limits
  • returned candles are sorted in ascending time order, from older to newer

Time range semantics:

  • from is inclusive
  • to is exclusive
  • A candle is included if its open time is greater than or equal to from and strictly less than to
  • Example: for H1 candles, from=12:00, to=13:00 returns the candle with open time 12:00, not a separate 13:00 candle.

Historical data availability depends on timeframe:

  • S1 → 1 day
  • S5 → 5 days
  • S15 → 15 days
  • M1, M3 → 1 year
  • M5, M10 → 2 years
  • M15, M30 → 3 years
  • H1+ → full available history

Possible public error codes include:

  • REQUEST_INVALID_PARAMETERS
  • REQUEST_INVALID_TIMEFRAME
  • REQUEST_INVALID_TIME_RANGE
  • REQUEST_INVALID_COUNT
  • REQUEST_INVALID_PRICE_TYPE
  • MARKET_INSTRUMENT_NOT_FOUND
  • MARKET_NO_QUOTES

Request​

Responses​

Candle history returned successfully