Aggregate PnL summary and top 5 trades for any wallet address via Nansen's blockchain analytics API.
What it does
This endpoint returns aggregate profit-and-loss statistics and the top 5 most profitable tokens for a specific wallet address on supported blockchains. It is part of Nansen's Profiler suite and accepts a POST request with an address (or entity name), chain, and date range. The response includes total realized PnL in USD, realized PnL percentage, win rate, number of traded tokens, total trade count, and a list of the top 5 tokens by realized profit with their ROI and chain details.
The endpoint supports over 15 chains including Ethereum, Solana, Base, Arbitrum, Polygon, BNB, and others. It costs $0.01 per call via the x402 payment protocol, or 10 credits on the free tier / 1 credit on the pro tier using Nansen's credit system. Rate limits are enforced per-second and per-minute, with remaining credits and rate limit info returned in response headers.
The API is documented via a full OpenAPI 3.1 spec served from api.nansen.ai. Authentication is via an API key header or x402 micropayment. The endpoint is live and returns HTTP 402 to unauthenticated callers, which is the expected MPP/x402 payment challenge behavior.
Capabilities
Use cases
- —Evaluate a wallet's overall trading performance across chains before copying trades
- —Screen smart money addresses by realized PnL and win rate
- —Build dashboards showing top profitable tokens for any address
- —Automate due diligence on counterparty wallets in DeFi
- —Feed wallet performance data into trading bots or agent workflows
Fit
Best for
- —Agents needing quick wallet-level PnL summaries
- —Multi-chain realized profit analysis for any address
- —Identifying top-performing tokens in a wallet's history
Not for
- —Real-time streaming trade data (use DEX trades endpoints instead)
- —NFT-specific PnL analysis
- —Free-tier heavy usage (10 credits per call on free plan)
Quick start
curl -X POST https://api.nansen.ai/api/v1/profiler/address/pnl-summary \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-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.62,
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": true
},
"top5_tokens": [
{
"chain": "ethereum",
"realized_pnl": 12500.5,
"realized_roi": 2.35,
"token_symbol": "PEPE",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}
],
"traded_times": 187,
"realized_pnl_usd": 35200.75,
"traded_token_count": 42,
"realized_pnl_percent": 0.45
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.01/call via x402), live 402 challenge confirmed, and comprehensive endpoint description. Minor deduction because the specific response schema fields for this endpoint are referenced but not fully inlined in the probe, and no crawled documentation page was available beyond the OpenAPI spec.
Warnings
- —No dedicated documentation pages were reachable (docs, pricing pages returned 404); all information derived from OpenAPI spec.
- —Example response is constructed from the schema definition — no actual sample response was captured from the probe.
Citations
- —Endpoint costs $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
- —Supports chains including ethereum, solana, base, arbitrum, avalanche, bnb, polygon, and othershttps://api.nansen.ai
- —Endpoint is live and returns HTTP 402 to unauthenticated callershttps://api.nansen.ai