Get Open Interest

Get the current open interest (total number of outstanding contracts) for a futures symbol.

HTTP Request

GET /api/v1/future/market/open-interest

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/open-interest?symbol=BTCUSDT"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object/null	Open interest data (null if not available)
> openInterestList	array	List of open interest data
>> symbol	string	Trading pair symbol
>> size	string	Total open interest size
> ts	number	Data timestamp in milliseconds (Unix timestamp)

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "openInterestList": [
      {
        "symbol": "BTCUSDT",
        "size": "12345.678"
      }
    ],
    "ts": 1763459280833
  }
}

Success Response (No Data)

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": null
}

Error Codes

Code	Message
40034	symbol does not exist
50010	Upstream response invalid