Hunt Townh402
Catalog
CryptoPOSTlive

Perp leaderboard

Get the perpetual futures trading leaderboard (top traders by PnL, ROI and account value) for a date range.

$0.05
per call
Success
100%
p50 latency
1.90s
p95 latency
1.92s
Calls (30d)
2

Provider contract

Call path
/routes/nansen/crypto/perp-leaderboard
Method
POST
Selected provider
nansendefault
Provider price
$0.05
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/nansen/crypto/perp-leaderboard' \
  -H 'content-type: application/json' \
  -d '{"date":{"from":"2026-05-15","to":"2026-05-21"}}'
CLI
h402 call 'crypto/perp-leaderboard' --provider 'nansen' --method POST --json '{"date":{"from":"2026-05-15","to":"2026-05-21"}}'

Parameters & live test

pays real USDC

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.

dateobjectrequired

Date range in YYYY-MM-DD format for the leaderboard window, with from and to fields.

date.fromstringrequired

Inclusive range start.

e.g.
date.tostringrequired

Inclusive range end.

e.g.
premium_labelsbooleanoptional

Label tier control. Omit for plan-default labels, false for free-tier labels, true for premium labels. Nansen will change the default to false in a future release; pass true to keep premium labels.

paginationobjectoptional

Optional pagination, e.g. { "page": 1, "perPage": 10 }.

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–1000

Results per page (max 1000).

POST/routes/nansen/crypto/perp-leaderboard
Request body
{
  "date": {
    "from": "2026-05-15",
    "to": "2026-05-21"
  }
}

ResponseExample response
{
  "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"
  }
}

Providers

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.

nansen
x402
100
Success
100%
p50
1.90s
Calls
2
100%
$0.05$0.050/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider