MPPtempoquality 0.92

Rank the most profitable Hyperliquid perpetual traders by PnL, ROI, and account value over any date range.

Price
$0.05 / call
Protocol
mpp
Verified
no
Endpoint
https://api.nansen.ai/api/v1/perp-leaderboard

What it does

The Nansen Perp Leaderboard endpoint (`/api/v1/perp-leaderboard`) returns a ranked list of the most profitable perpetual traders on Hyperliquid within a specified date range. Each record includes the trader's wallet address, Nansen label, total PnL in USD, ROI percentage, and account value. Results can be filtered by trader address, PnL range, ROI range, account value, and smart money labels (e.g., "Smart HL Perps Trader"). Sorting is configurable by total_pnl, roi, or account_value. Premium labels are available for deeper wallet identification.

The endpoint is part of Nansen's broader blockchain analytics API (v1), which covers smart money tracking, wallet profiling, token flows, prediction markets, and more across 20+ chains. This specific endpoint focuses exclusively on Hyperliquid perpetual contract performance. It accepts POST requests with a JSON body containing a required date range and optional filters, pagination, and sort parameters. The response includes paginated leaderboard data with rate-limit and credit-usage headers.

Pricing is $0.05 per call via the x402 protocol, or 50 credits (free tier) / 5 credits (pro tier) when using a Nansen API key. The endpoint returned HTTP 402 on probe, confirming it is live and accepting payment challenges. Account value data is limited to the top 500K traders due to upstream Hyperliquid constraints.

Capabilities

hyperliquid-perp-leaderboardtrader-pnl-rankingroi-calculationsmart-money-filteringwallet-labelingperpetual-trading-analyticsdate-range-querypaginationcustom-sorting

Use cases

  • —Identify the most profitable Hyperliquid perpetual traders over a specific time period
  • —Screen for smart money perp traders with high ROI and large account values
  • —Build automated trading signals based on top trader activity
  • —Research which wallets are consistently profitable on Hyperliquid perps
  • —Rank traders by PnL to find alpha-generating addresses for copy-trading strategies

Fit

Best for

  • —Quantitative researchers analyzing Hyperliquid perpetual trading performance
  • —Trading bots that need programmatic access to top trader rankings
  • —Portfolio managers screening for smart money perpetual positions
  • —On-chain analytics dashboards displaying perp leaderboards

Not for

  • —Spot/DEX trading analytics on other chains (use Nansen's other endpoints instead)
  • —Real-time sub-second trade streaming (this is a batch leaderboard endpoint)
  • —Historical data beyond what Hyperliquid provides for account values (top 500K only)

Quick start

curl -X POST https://api.nansen.ai/api/v1/perp-leaderboard \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{
    "date": {"from": "2025-01-01", "to": "2025-01-31"},
    "pagination": {"page": 1, "per_page": 10},
    "order_by": [{"field": "total_pnl", "direction": "DESC"}]
  }'

Example

Request

{
  "date": {
    "to": "2025-01-31",
    "from": "2025-01-01"
  },
  "filters": {
    "total_pnl": {
      "min": 1000
    }
  },
  "order_by": [
    {
      "field": "total_pnl",
      "direction": "DESC"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 5
  }
}

Response

{
  "data": [
    {
      "roi": 15.5,
      "total_pnl": 125000.5,
      "account_value": 850000,
      "trader_address": "0x28c6c06298d514db089934071355e5743bf21d60",
      "trader_address_label": "🏦 Binance 14 [0x28c6c0]"
    },
    {
      "roi": 22.3,
      "total_pnl": 98000.25,
      "account_value": 440000,
      "trader_address": "0xa312114b5795dff9b8db50474dd57701aa78ad1e",
      "trader_address_label": "Smart HL Perps Trader [0xa31211]"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 5,
    "is_last_page": false
  }
}

Endpoint

URLhttps://api.nansen.ai/api/v1/perp-leaderboard
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.92/ 1.00

Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.05/call via x402), live 402 probe confirming endpoint is operational, comprehensive filter and sort documentation. Minor deduction because no crawled docs page was reachable and response examples are inferred from schema rather than captured live.

Warnings

  • —Account value data is only available for the top 500K Hyperliquid traders; others may show 0 or null.
  • —Premium labels (premium_labels=true) may cost more credits (150 pro credits) and default behavior may change in a future release.

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 16:00:27Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/WfyDyY