PnL Leaderboard

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

Body

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-05-01",
      "to": "2025-05-03"
    },
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  },
  "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"
  }
]