Aggregate PnL summary and top profitable tokens for any wallet address via Nansen on-chain analytics.
What it does
The Nansen Address PnL Summary endpoint returns aggregate profit-and-loss statistics for a specific wallet address or named entity on a given blockchain. It provides realized PnL in USD, realized PnL as a percentage, win rate, total traded token count, number of trades, and the top 5 tokens by realized profit. The endpoint accepts a POST request with a JSON body specifying the address (or entity name), chain, and date range.
This endpoint is part of the broader Nansen API v1, which covers smart money tracking, token analytics (Token God Mode), wallet profiling, prediction markets (Polymarket), perpetual trading data (Hyperliquid), and an AI research agent. The PnL summary sits in the Profiler category and is priced at $0.01 per call via the x402 protocol (or 10 credits on the free tier, 1 credit on the pro tier). Supported chains include Ethereum, Solana, Base, Arbitrum, Polygon, BNB, and many others. Rate limits are enforced per-second and per-minute, reported via response headers.
Capabilities
Use cases
- —Evaluate a wallet's overall trading performance before copying trades
- —Assess win rate and realized PnL of a potential counterparty or fund
- —Build dashboards showing top-performing tokens for any address
- —Screen smart money wallets by realized profit metrics
- —Automate due diligence on DeFi wallets for compliance or research
Fit
Best for
- —Agents that need quick wallet-level trading performance summaries
- —Portfolio analytics tools requiring realized PnL and win rate
- —Research workflows evaluating smart money or fund wallets
- —Multi-chain wallet profiling across 17+ EVM and non-EVM chains
Not for
- —Real-time streaming price feeds or tick-level trade data
- —NFT-specific analytics (this endpoint covers fungible token PnL)
- —Users who need free unlimited access (each call costs $0.01 via x402)
Quick start
curl -X POST https://api.nansen.ai/api/v1/profiler/address/pnl-summary \
-H 'Content-Type: application/json' \
-d '{
"address": "0x39d52da6beec991f075eebe577474fd105c5caec",
"chain": "ethereum",
"date": {"from": "2025-01-01T00:00:00Z", "to": "2025-06-01T23:59:59Z"}
}'Example
Request
{
"date": {
"to": "2025-06-01T23:59:59Z",
"from": "2025-01-01T00:00:00Z"
},
"chain": "ethereum",
"address": "0x39d52da6beec991f075eebe577474fd105c5caec"
}Response
{
"win_rate": 0.68,
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": true
},
"top5_tokens": [
{
"chain": "ethereum",
"realized_pnl": 12500.5,
"realized_roi": 1.25,
"token_symbol": "USDC",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
],
"traded_times": 42,
"realized_pnl_usd": 35000.75,
"traded_token_count": 15,
"realized_pnl_percent": 0.45
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear x402 pricing ($0.01/call), live 402 challenge confirmed, and comprehensive endpoint documentation. Minor gap: no example response in the OpenAPI spec itself, so the example response was inferred from the schema.
Warnings
- —No crawled documentation pages were available beyond the API root health check; all information is derived from the OpenAPI spec.
Citations
- —Endpoint is priced at $0.01 per call via x402 protocolhttps://api.nansen.ai
- —Credit cost is 10 (free tier) or 1 (pro tier)https://api.nansen.ai
- —Endpoint returns realized PnL, win rate, traded token count, traded times, and top 5 tokenshttps://api.nansen.ai
- —Supported chains include ethereum, solana, base, arbitrum, polygon, bnb, and others per ProfilerPnLChain enumhttps://api.nansen.ai
- —x402 402 challenge was captured live from the endpointhttps://api.nansen.ai/api/v1/profiler/address/pnl-summary