Top Trader Long/Short Ratio (Accounts)

Description

Get the long/short account ratio of top traders (top 20% of accounts by position size).

This endpoint returns a single current snapshot (an array with one element), not a historical series. The period, limit, startTime, and endTime parameters are accepted but currently ignored.

HTTP Request

GET /futures/data/topLongShortAccountRatio

Request Parameters

Name	Type	Required	Description
symbol	STRING	YES	Trading pair
period	ENUM	NO	Accepted but currently ignored
limit	INT	NO	Accepted but currently ignored
startTime	LONG	NO	Accepted but currently ignored
endTime	LONG	NO	Accepted but currently ignored

Response Example

[
  {
    "symbol": "BTCUSDT",
    "longShortRatio": "0.1979",       // Long/short ratio
    "longAccount": "0.167854",      // Long account ratio
    "shortAccount": "0.848243",     // Short account ratio
    "timestamp": "1583127600000"     // Timestamp (string)
  }
]

Code Examples

cURL

curl -s "https://api.prex.world/futures/data/topLongShortAccountRatio?symbol=BTCUSDT&period=1h&limit=5"

Python

import requests

base_url = "https://api.prex.world"
params = {"symbol": "BTCUSDT", "period": "1h", "limit": 5}
response = requests.get(f"{base_url}/futures/data/topLongShortAccountRatio", params=params)
for record in response.json():
    print(f"{record['symbol']}: L/S={record['longShortRatio']} Long={record['longAccount']} Short={record['shortAccount']}")