PnL Leaderboard

tgm/pnl-leaderboard

post

This endoint includes, 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?

Parameters | Parameter | Type | Description | | ---------------- | ---------------------- | ------------------------------- | | token_address | FixedString(42) | hexadecimal address of token to profile. | | date_from | String | Date range start input, format YYYY-MM-DD | | date_to | String | Date range end input, format YYYY-MM-DD |

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
Content-Type: application/json
Accept: */*
Content-Length: 142

{
  "parameters": {
    "chain": "ethereum",
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  }
}

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