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
post
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"
  }
]

Last updated

Was this helpful?