Trade Performance

profiler/address/pnl-summary

post

This endpoint includues aggregated PnL stats for the input address.

Parameters

Parameter	Type	Description
wallet_address	FixedString(42)	hexadecimal addresse of wallet 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/profiler/address/pnl-summary HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 143

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

[
  {
    "top5Tokens": "text",
    "tradedToken": "text",
    "tradedTimes": "text",
    "realizedPnlUsd": "text",
    "realizedPnlPercent": "text",
    "winRate": "text",
    "averageRoiPerTrade": "text"
  }
]

profiler/address/pnl

post

This endpoint includes trade performance metrics for each token traded by the address.

Parameters

Parameter	Type	Description
wallet_address	FixedString(42)	hexadecimal addresse of wallet to profile.
token_address	FixedString(42)	(optional) hexadecimal addresse of token.
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/profiler/address/pnl HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 223

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

[
  {
    "tokenAddress": "text",
    "tokenSymbol": "text",
    "tokenLogo": "text",
    "tokenPrice": "text",
    "roiPercentRealised": "text",
    "pnlUsdRealised": "text",
    "pnlUsdUnrealised": "text",
    "roiPercentUnrealised": "text",
    "boughtAmount": "text",
    "boughtUsd": "text",
    "costBasisUsd": "text",
    "soldAmount": "text",
    "soldUsd": "text",
    "avgSoldPriceUsd": "text",
    "holdingAmount": "text",
    "holdingUsd": "text",
    "nofBuys": "text",
    "nofSells": "text",
    "maxBalanceHeld": "text",
    "maxBalanceHeldUsd": "text"
  }
]