PnL Leaderboard

Deprecation Notice: The ‎/beta API endpoints will be deprecated on 01 October 2025. Please migrate your integrations to the ‎/v1 endpoints before this date to ensure uninterrupted service.

tgm/pnl-leaderboard

post

This question calculates, for each token address that traded the input token, stats related to amounts sold and bought, realised and unrealised pnl and roi, cost basis and avg sell price. Questions you can answer using this model are: 1. What is the realised and unrealised profits for each trader who traded the input token? 2. What is the cost basis and average sale price of each trader? 3. Who is the trader with the highest realised or unrealised profit on the input token?

Authorizations

ApiKeyAuth

Body

application/json

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/pnl-leaderboard HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 187

{
  "parameters": {
    "chain": "ethereum",
    "date": {
      "from": "2025-07-14",
      "to": "2025-07-15"
    },
    "tokenAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "traderAddress": "text",
    "fullName": "text",
    "tokenPrice": 1,
    "pnlUsdRealised": 1,
    "pnlUsdUnrealised": 1,
    "holdingAmount": 1,
    "holdingUsd": 1,
    "maxBalanceHeld": 1,
    "maxBalanceHeldUsd": 1,
    "stillHoldingBalanceRatio": "text"
  }
]