Get Open Interest

Get the open interest of each symbol.

Covers: USDT contract / USDC contract / Inverse contract

info

• The upper limit time you can query is the launch time of the symbol.
• During periods of extreme market volatility, this interface may experience increased latency or temporary delays in data delivery

HTTP Request

GET/v5/market/open-interest

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type. linear,inverse
symbol	true	string	Symbol name, like BTCUSDT, uppercase only
intervalTime	true	string	Interval time. 5min,15min,30min,1h,4h,1d
startTime	false	integer	The start timestamp (ms)
endTime	false	integer	The end timestamp (ms)
limit	false	integer	Limit for data size per page. [1, 200]. Default: 50
cursor	false	string	Cursor. Used to paginate

Response Parameters

Parameter	Type	Comments
category	string	Product type
symbol	string	Symbol name
list	array	Object
> openInterest	string	Open interest. The value is the sum of both sides. The unit of value, e.g., BTCUSD(inverse) is USD, BTCUSDT(linear) is BTC
> singleOpenInterest	string	Open interest. The value is the single side. The unit of value, e.g., BTCUSD(inverse) is USD, BTCUSDT(linear) is BTC
> timestamp	string	The timestamp (ms)
nextPageCursor	string	Used to paginate

---

Request Example

HTTP

GET /v5/market/open-interest?limit=5&category=inverse&intervalTime=1d&symbol=BTCUSD HTTP/1.1
Host: api-testnet.bybit.com

Python

from pybit.unified_trading import HTTP
session = HTTP(testnet=True)
print(session.get_open_interest(
    category="inverse",
    symbol="BTCUSD",
    intervalTime="5min",
    startTime=1669571100000,
    endTime=1669571400000,
))

GO

import (
    "context"
    "fmt"
    bybit "github.com/bybit-exchange/bybit.go.api"
)
client := bybit.NewBybitHttpClient("", "", bybit.WithBaseURL(bybit.TESTNET))
params := map[string]interface{}{"category": "linear", "symbol": "BTCUSDT"}
client.NewUtaBybitServiceWithParams(params).GetOpenInterests(context.Background())

Java

import com.bybit.api.client.domain.CategoryType;
import com.bybit.api.client.domain.market.*;
import com.bybit.api.client.domain.market.request.MarketDataRequest;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance().newAsyncMarketDataRestClient();
var openInterest = MarketDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").marketInterval(MarketInterval.FIVE_MINUTES).build();
client.getOpenInterest(openInterest, System.out::println);

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
});

client
    .getOpenInterest({
        category: 'inverse',
        symbol: 'BTCUSD',
        intervalTime: '5min',
        startTime: 1669571100000,
        endTime: 1669571400000,
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "symbol": "BTCUSD",
        "category": "inverse",
        "list": [
            {
                "openInterest": "63910691.00000000",
                "singleOpenInterest": "31955346",
                "timestamp": "1780963200000"
            },
            {
                "openInterest": "63910691.00000000",
                "singleOpenInterest": "31955346",
                "timestamp": "1780876800000"
            },
            {
                "openInterest": "63910691.00000000",
                "singleOpenInterest": "31955346",
                "timestamp": "1780790400000"
            },
            {
                "openInterest": "63942311.00000000",
                "singleOpenInterest": "31971156",
                "timestamp": "1780704000000"
            },
            {
                "openInterest": "63942311.00000000",
                "singleOpenInterest": "31971156",
                "timestamp": "1780617600000"
            }
        ],
        "nextPageCursor": "lastid%3D19408935%26lasttime%3D1780617600"
    },
    "retExtInfo": {},
    "time": 1780994051392
}