Get Long Short Ratio

This refers to the net long and short positions as percentages of all position holders during the selected time.
Long account ratio = Number of holders with long positions / Total number of holders
Short account ratio = Number of holders with short positions / Total number of holders
Long-short account ratio = Long account ratio / Short account ratio

HTTP Request

GET /v5/market/account-ratio

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type. linear(USDT Contract),inverse
symbol	true	string	Symbol name, like BTCUSDT, uppercase only
period	true	string	Data recording period. 5min, 15min, 30min, 1h, 4h, 1d
startTime	false	string	The start timestamp (ms)
endTime	false	string	The end timestamp (ms)
limit	false	integer	Limit for data size per page. [1, 500]. Default: 50
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Parameter	Type	Comments
list	array	Object
> symbol	string	Symbol name
> buyRatio	string	The ratio of the number of long position
> sellRatio	string	The ratio of the number of short position
> timestamp	string	Timestamp (ms)
nextPageCursor	string	Refer to the cursor request parameter

---

Request Example

HTTP

GET /v5/market/account-ratio?category=linear&symbol=BTCUSDT&period=1h&limit=2&startTime=1696089600000&endTime=1696262400000 HTTP/1.1
Host: api-testnet.bybit.com

Python

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", "period": "5min"}
client.NewUtaBybitServiceWithParams(params).GetLongShortRatio(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 marketAccountRatioRequest = MarketDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").dataRecordingPeriod(DataRecordingPeriod.FIFTEEN_MINUTES).limit(10).build();
client.getMarketAccountRatio(marketAccountRatioRequest, System.out::println);

Node.js

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

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

client
  .getLongShortRatio({
    category: 'linear',
    symbol: 'BTCUSDT',
    period: '1h',
    limit: 100,
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "symbol": "BTCUSDT",
                "buyRatio": "0.49",
                "sellRatio": "0.51",
                "timestamp": "1696262400000"
            },
            {
                "symbol": "BTCUSDT",
                "buyRatio": "0.4927",
                "sellRatio": "0.5073",
                "timestamp": "1696258800000"
            }
        ],
        "nextPageCursor": "lastid%3D0%26lasttime%3D1696258800"
    },
    "retExtInfo": {},
    "time": 1731567491688
}