Get OHLCV candles for charting.
GET/v1/instruments/:instrument_id/candles
Returns time-bucketed OHLCV bars. The from/to window is in Unix seconds;
either from + to OR countback + to should be supplied. Bars include a closed
boolean — true means the bar window has elapsed and the values are final; the latest
in-flight bar omits closed and may update on the candles WebSocket channel.
History depth (0.13.0): recent bars come from the edge's in-memory window; older bars are
served transparently from the durable candle store (retention: 1m 120 days, 5m 2 years,
15m/1h/1d indefinitely). At most 12,000 bars per call — page back by moving to.
Request
Responses
- 200
- 400
- 503
Candle series.
Request was malformed or failed validation. The error.code field carries the
machine-readable reason; common values include invalid_request, invalid_json,
invalid_order_id, invalid_instrument_id, invalid_credential_id,
invalid_resolution, and operation-specific codes documented per endpoint.
A required downstream (matching engine, ClickHouse, custody, instrument service) is unreachable. The request was not processed; retry with backoff.