Get Top Trader Long/Short Position Ratio

Get the ratio of long versus short positions held by top traders for a futures symbol over a specified time period.

HTTP Request

GET /api/v1/future/market/top-trader-position-long-short

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
period	string	Yes	Time period: "5m", "15m", "30m", "1h", "2h", "4h", "6h", "8h", "12h", "1d"

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/top-trader-position-long-short?symbol=BTCUSDT&period=1h"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	array	Array of top trader position ratio data
> longRatio	string	Percentage of long positions held by top traders
> shortRatio	string	Percentage of short positions held by top traders
> longShortRatio	string	Ratio of long positions to short positions
> ts	string	Timestamp in milliseconds (Unix timestamp)

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": [
    {
      "longRatio": "0.52",
      "shortRatio": "0.48",
      "longShortRatio": "1.08",
      "ts": "1732000123456"
    }
  ]
}

Error Codes

Code	Message
40034	symbol does not exist
40034	period does not exist
50010	Upstream response invalid