Top Traders by Account Value

Get top traders by account value with active perp positions

get

Returns top wallets ranked by account value (default) among traders with active perp positions. Supports sorting by account_value, position_value, position_size, or unrealized_pnl. Optionally filter by token — position_size is only available when a token is specified.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: 1 · max: 100Optional

Number of wallets to return

Default: 50

sort_bystringOptional

Field to sort by

Default: account_valuePattern: ^(account_value|position_value|position_size|unrealized_pnl)$

sort_orderstringOptional

Sort direction

Default: descPattern: ^(asc|desc)$

tokenany ofOptional

Optional token filter (e.g. BTC, ETH). Omit to aggregate all tokens.

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

totalintegerRequired

422

Validation Error

application/json

get

/v1/trader/rankings/account-value

HTTPcURLJavaScriptPython

GET /v1/trader/rankings/account-value HTTP/1.1
Host: data.blockliquidity.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "address": "text",
      "account_value": 1,
      "position_value": 1,
      "position_size": 1,
      "unrealized_pnl": 1
    }
  ],
  "total": 1
}