Top Traders by PnL

Get top wallets by PnL grouped by day

get

Retrieve top X wallets ranked by PnL for each day in the specified date range. Returns data grouped by day in descending order. Maximum date range: 30 days.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

start_timestampintegerRequired

Start timestamp in Unix epoch milliseconds

end_timestampintegerRequired

End timestamp in Unix epoch milliseconds

limitinteger · min: 1 · max: 100Optional

Number of top wallets to return per day

Default: 10

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/trader/rankings

HTTPcURLJavaScriptPython

GET /v1/trader/rankings?start_timestamp=1&end_timestamp=1 HTTP/1.1
Host: data.blockliquidity.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "timestamp": 1,
      "rankings": [
        {
          "address": "text",
          "pnl_rank": 1,
          "net_pnl": 1
        }
      ]
    }
  ]
}