Trade Performance

profiler/address/pnl-summary

post

This table contains aggregate stats of overall realised pnl for the input wallet. It also lists the top 5 tokens by realised profit. Questions you can answer using this model are:

  1. What are the top profitable tokens for the input address? 2. What is the realised profit and roi over all tokens traded by the input address? 3. What is the winrate for the input address?

Authorizations
Body
Responses
200
Successful response
application/json
post
POST /api/beta/profiler/address/pnl-summary HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 188

{
  "parameters": {
    "chain": "ethereum",
    "walletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    }
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}
[
  {
    "top5Tokens": [
      [
        "text"
      ]
    ],
    "tradedToken": 1,
    "tradedTimes": 1,
    "realizedPnlUsd": 1,
    "realizedPnlPercent": 1,
    "winRate": 1,
    "averageRoiPerTrade": 1
  }
]

profiler/address/pnl

post

This question calculates, for each token traded by the input address, 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 token traded by the input address? 2. What is the cost basis and average sale price of each token traded by the input address? 3. How many of a specific token was bought by the input address in the last 90 days, 1 year or all time?

Authorizations
Body
Responses
200
Successful response
application/json
post
POST /api/beta/profiler/address/pnl HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 268

{
  "parameters": {
    "chain": "ethereum",
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "walletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
    "showRealized": true,
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}
[
  {
    "tokenAddress": "text",
    "tokenSymbol": "text",
    "tokenPrice": 1,
    "roiPercentRealised": 1,
    "pnlUsdRealised": 1,
    "pnlUsdUnrealised": 1,
    "roiPercentUnrealised": 1,
    "boughtAmount": 1,
    "boughtUsd": 1,
    "costBasisUsd": 1,
    "soldAmount": 1,
    "soldUsd": 1,
    "avgSoldPriceUsd": 1,
    "holdingAmount": 1,
    "holdingUsd": 1,
    "nofBuys": "text",
    "nofSells": "text",
    "maxBalanceHeld": 1,
    "maxBalanceHeldUsd": 1
  }
]

Usage Tips

Querying PnL across all chains

You can also query balances across all chains using this

"chain": "all",
PreviousCounterpartiesNextToken God Mode

Last updated

Was this helpful?