Skip to navigation

Get open interest history

Retrieve the historical contract open interest statistics of futures and perpetual swaps for a specific instrument.

Query parameters

instIdstringRequired

Instrument ID, e.g. BTC-USDT-SWAP. Only applicable to FUTURES and SWAP.

periodenumOptional
Bar size, the default is 5m.
endstringOptional
Pagination of data to return records earlier than the requested timestamp, Unix timestamp in milliseconds.
beginstringOptional
Return records newer than the requested timestamp, Unix timestamp in milliseconds.
limitstringOptional
Number of results per request. The maximum is 100. The default is 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 stringsOptional