Skip to navigation
API ReferenceMarket

Get mark price candlesticks

Retrieve candlestick (OHLC) data of the mark price. Mark price candles do not include a volume field.

Query parameters

instIdstringRequired

Instrument ID, e.g. BTC-USDT-SWAP.

barstringOptional

Bar size / time interval, e.g. 1m, 5m, 1H, 1D. Default 1m.

afterstringOptional

Pagination: return records earlier than the requested ts (Unix timestamp in ms).

beforestringOptional

Pagination: return records newer than the requested ts (Unix timestamp in ms).

limitstringOptional
Number of results per request. Maximum 100, default 100.

Response

Successful response
codestringOptional

Result code. 0 means success; any other value is an error code.

msgstringOptional
Error message. Empty on success.
datalist of lists of anyOptional