Top Traders by Win Rate

Get top traders by winrate on a specific token

get

Returns traders ranked by total realized PnL (default) on a specific token, filtered by minimum winrate and minimum realized PnL thresholds. Supported periods: 1d, 7d, 30d, all.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

tokenstringRequired

Token to filter on (e.g. BTC, ETH)

periodstringOptional

Time period: 1d, 7d, 30d, all

Default: 7dPattern: ^(1d|7d|30d|all)$

min_winratenumber · max: 1Optional

Minimum winrate threshold (0.0–1.0)

Default: 0.5

min_pnlnumberOptional

Minimum total realized PnL threshold in USD

Default: 0

limitinteger · min: 1 · max: 100Optional

Number of traders to return

Default: 50

sort_bystringOptional

Field to sort by

Default: total_realized_pnlPattern: ^(total_realized_pnl|winrate|total_volume|closed_trade_count)$

sort_orderstringOptional

Sort direction

Default: descPattern: ^(asc|desc)$

Responses

200

Successful Response

application/json

totalintegerRequired

422

Validation Error

application/json

get

/v1/trader/rankings/winrate

HTTPcURLJavaScriptPython

GET /v1/trader/rankings/winrate?token=text HTTP/1.1
Host: data.blockliquidity.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "address": "text",
      "closed_trade_count": 1,
      "profit_closed_trade_count": 1,
      "total_trade_count": 1,
      "total_volume": 1,
      "winrate": 1,
      "total_realized_pnl": 1
    }
  ],
  "total": 1
}