Trader Rank API

Endpoint

GET https://api.leagueoftraders.io/v3/trader/rank

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading symbol (e.g., "BTC")
period	integer	Yes	Period in days (1, 7, 30, 90, 180)

Response

Success Response (200)

{
  "status": 200,
  "data": {
    "symbol": "BTC",
    "period": 30,
    "window_date": "2025-07-21T00:00:00Z",
    "rankings": [
      {
        "rank": 1,
        "trader_id": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "trader_name": "xxxxxxxxxx",
        "volume_share": 39.69853243045697,
        "trade_count": 96,
        "win_loss_ratio": 84,
        "mdd": 35.76,
        "avg_holdings": 53627
      }
    ],
    "updated_at": "2025-08-20T07:10:46.970437Z"
  }
}

Response Fields

Data Object

Field	Type	Description
symbol	string	Trading symbol
period	integer	Period in days
window_date	string	Window date (ISO 8601)
rankings	array	Array of trader ranking objects
updated_at	string	Last update timestamp (ISO 8601)

Ranking Object

Field	Type	Description
rank	integer	Trader rank position
trader_id	string	Trader ID
trader_name	string	Trader name
percentage	number	Volume share percentage per trader
trade_count	integer	Number of trades
win_loss_ratio	integer	Win/loss ratio (optional)
mdd	number	Maximum drawdown
avg_holdings	number	Average duration (in seconds) a trader holds a token

Notes

• Optional fields may not be present in all records
• Rankings are ordered by volume performance