MPPtempoquality 0.88

Rank traders by realized and unrealized PnL for any token via Nansen's on-chain analytics.

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

What it does

The Nansen TGM PnL Leaderboard endpoint ranks traders by their profit-and-loss performance for a specific token on a given chain and date range. It returns both realized profits (from completed trades) and unrealized profits (from current holdings), along with ROI percentages, holding amounts, netflow data, and trade counts for each trader address. Results include Nansen wallet labels and support filtering by trader address, PnL ranges, holding amounts, and number of trades. Pagination and custom sort ordering are supported.

This endpoint is part of Nansen's Token God Mode (TGM) suite, which provides deep token-level analytics across 17+ chains including Ethereum, Solana, Base, Arbitrum, and others. The PnL leaderboard requires a chain, token address, and date range as inputs. It costs $0.05 per call via x402 payment, or 50 credits (free tier) / 5 credits (pro tier) with an API key. Premium labels (smart money, alpha trader) are available at higher credit cost. Rate limits are enforced per-second and per-minute, reported via response headers.

Capabilities

pnl-leaderboardtoken-analyticswallet-profilingrealized-pnlunrealized-pnlroi-calculationsmart-money-labelsmulti-chainpaginationcustom-sortingx402-payment

Use cases

  • —Identify the most profitable traders for a specific token over a given time period
  • —Analyze which wallets are accumulating unrealized gains on a token
  • —Compare realized vs unrealized PnL across traders for due diligence
  • —Screen for smart money activity on newly launched tokens
  • —Build alpha signals by tracking top-performing wallet addresses

Fit

Best for

  • —Crypto researchers analyzing per-token trader performance
  • —Trading bots that follow profitable wallet strategies
  • —Portfolio managers evaluating token-level smart money behavior
  • —DeFi analysts building PnL attribution dashboards

Not for

  • —Real-time sub-second trading signals (data has some latency)
  • —Non-blockchain financial data or traditional equities analysis
  • —Free unlimited usage without payment (requires x402 or API key credits)

Quick start

curl -X POST https://api.nansen.ai/api/v1/tgm/pnl-leaderboard \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{
    "chain": "ethereum",
    "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "date": {"from": "2025-01-01T00:00:00Z", "to": "2025-01-31T23:59:59Z"},
    "pagination": {"page": 1, "per_page": 10}
  }'

Example

Request

{
  "date": {
    "to": "2025-01-31T23:59:59Z",
    "from": "2025-01-01T00:00:00Z"
  },
  "chain": "ethereum",
  "order_by": [
    {
      "field": "pnl_usd_realised",
      "direction": "DESC"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}

Response

{
  "data": [
    {
      "price_usd": 0.0000123,
      "nof_trades": 25,
      "holding_usd": 61500,
      "pnl_usd_total": 135025.5,
      "holding_amount": 5000000000,
      "trader_address": "0x28c6c06298d514db089934071355e5743bf21d60",
      "max_balance_held": 10000000000,
      "pnl_usd_realised": 125000.5,
      "roi_percent_total": 15.5,
      "pnl_usd_unrealised": 10025,
      "max_balance_held_usd": 123000,
      "roi_percent_realised": 12.3,
      "trader_address_label": "Binance 14",
      "roi_percent_unrealised": 3.2,
      "still_holding_balance_ratio": 0.5
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": false
  }
}

Endpoint

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

Quality

0.88/ 1.00

Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.05/call via x402), and the endpoint returned 402 confirming it is live. Docs are comprehensive from the OpenAPI spec. Minor deduction because no direct crawl-based documentation pages were available (all returned route-not-found errors), so all info comes from the OpenAPI spec alone.

Warnings

  • —No standalone documentation pages were reachable at api.nansen.ai/docs or similar paths; all endpoint details are derived from the OpenAPI spec.
  • —Premium labels variant costs significantly more credits (150 pro credits vs 5 standard); ensure you set premium_labels explicitly if needed.

Citations

Provenance

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

Agent access

JSONhttps://clawmart.sh/api/listings/44Degn