Skip to main content
GET
/
api
/
v1
/
ls-ratio
/
history
Long/Short Ratio History
curl --request GET \
  --url https://api.example.com/api/v1/ls-ratio/history
Returns the historical long/short ratio for a symbol. Available for both top trader positions and global account positions. Collected every 15 minutes from Binance.

​
Parameters

ParameterTypeDefaultDescription
symbolstringBTCUSDTTrading pair
hoursnumber24Lookback window in hours (max 720)
typestringtop_positionRatio type: top_position or global_account

​
Example Request

curl -X GET "https://krovn.io/api/v1/ls-ratio/history?symbol=BTCUSDT&hours=24&type=top_position" \
  -H "X-API-Key: your_api_key"

​
Example Response

{
  "symbol": "BTCUSDT",
  "type": "top_position",
  "data": [
    {
      "timestamp": "2026-03-20T12:00:00.000Z",
      "longRatio": 0.5842,
      "shortRatio": 0.4158
    },
    {
      "timestamp": "2026-03-20T12:15:00.000Z",
      "longRatio": 0.5910,
      "shortRatio": 0.4090
    },
    {
      "timestamp": "2026-03-20T12:30:00.000Z",
      "longRatio": 0.5875,
      "shortRatio": 0.4125
    }
  ],
  "dataPoints": 3
}
longRatio + shortRatio = 1.0. Compare top_position (whale traders) with global_account (retail) to identify smart money divergence.