Loading capabilities…
Loading capability…
Get the perpetual futures trading leaderboard (top traders by PnL, ROI and account value) for a date range.
Both commands call the selected provider directly.
curl -X POST '/routes/nansen/crypto/perp-leaderboard' \
-H 'content-type: application/json' \
-d '{"premium_labels":false,"pagination":{"page":1,"per_page":10}}'h402 call 'crypto/perp-leaderboard' --provider 'nansen' --method POST --json '{"premium_labels":false,"pagination":{"page":1,"per_page":10}}'Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.
dateobjectrequiredLeaderboard window; either or both date bounds may be supplied.
date.fromstringoptionalInclusive range start.
date.tostringoptionalInclusive range end.
premium_labelsbooleanoptionaldefault falseInclude Nansen premium labels. Defaults to false.
paginationobjectoptionalOptional Nansen pagination using page and per_page.
pagination.pageintegeroptional≥ 1default 11-based page number.
pagination.per_pageintegeroptional1–1000default 10Results per page (max 1000).
filtersobjectoptionalOptional Nansen trader and leaderboard-value filters.
filters.trader_addressstring | array | nulloptionalTrader address, address list, or null.
filters.trader_address_labelstring | array | nulloptionalTrader address label, label list, or null.
filters.total_pnlobjectoptionalTotal PnL range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.roiobjectoptionalReturn-on-investment range.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.account_valueobjectoptionalAccount-value range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.include_smart_money_labelsarrayoptionalNansen Smart Money labels to include.
filters.exclude_smart_money_labelsarrayoptionalNansen Smart Money labels to exclude.
order_byarrayoptionalOptional leaderboard sort clauses.
Nested fields
fieldstringrequiredOne of total_pnl, roi, account_valueField to sort by.
directionstringrequiredOne of ASC, DESCSort direction.
{
"premium_labels": false,
"pagination": {
"page": 1,
"per_page": 10
}
}{ "data": { "data": [ { "trader_address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060", "trader_address_label": "HL Perps Whale", "total_pnl": 7772959.1899470035, "roi": 0.07082934993876308, "account_value": 20893412.911497 }, { "trader_address": "0x4e23288cee4960f9f962195c22948e4bc7ae20c3", "trader_address_label": "Token Millionaire", "total_pnl": 4240398.713102001, "roi": 0.11086005016168717, "account_value": 506441.191504 }, { "trader_address": "0xe0ffc829349c88c159462942ad885f12130e7610", "trader_address_label": "High Balance", "total_pnl": 3463357.1163480007, "roi": 0.2331298629321391, "account_value": 1674976.695531 } ], "pagination": { "page": 1, "per_page": 10, "is_last_page": false } }, "h402": { "routeId": "crypto/perp-leaderboard", "provider": "nansen", "selectedCandidateId": "crypto/perp-leaderboard/nansen", "routing": "manual", "paidBy": "x402-exact" } }
Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.