Skip to main content

Get Open Interest

Get the open interest of each symbol.

Covers: USDT perpetual / USDC contract / Inverse contract

  • The upper limit time you can query is the launch time of the symbol.

HTTP Request

GET /v5/market/open-interest

Request Parameters

categorytruestringProduct type. linear,inverse
symboltruestringSymbol name
intervalTimetruestringInterval time. 5min,15min,30min,1h,4h,1d
startTimefalseintegerThe start timestamp (ms)
endTimefalseintegerThe end timestamp (ms)
limitfalseintegerLimit for data size per page. [1, 200]. Default: 50
cursorfalsestringCursor. Used to paginate

Response Parameters

categorystringProduct type
symbolstringSymbol name
> openIntereststringOpen interest. The value is the sum of both sides
> timestampstringThe timestamp (ms)
nextPageCursorstringUsed to paginate

Request Example

GET /v5/market/open-interest?category=inverse&symbol=BTCUSD&intervalTime=5min&startTime=1669571100000&endTime=1669571400000 HTTP/1.1

Response Example

"retCode": 0,
"retMsg": "OK",
"result": {
"symbol": "BTCUSD",
"category": "inverse",
"list": [
"openInterest": "461134384.00000000",
"timestamp": "1669571400000"
"openInterest": "461134292.00000000",
"timestamp": "1669571100000"
"nextPageCursor": ""
"retExtInfo": {},
"time": 1672053548579