Address Summary
Data Freshness & Historical Coverage
For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.
Returns a current, point-in-time snapshot of the wallet's lifetime performance — there is no date-range parameter or historical look-back, and values reflect within the standard live latency.
Get wallet-level PnL summary for a single Polymarket trader. Returns realized PnL, unrealized PnL, win rate, and wallet age.
What it helps to answer:
What is this trader's overall Polymarket performance?
How many markets has this trader won vs traded?
How old is this wallet and when did it start trading?
API key for authentication
Request for address summary endpoint.
Wallet address (hex, with or without 0x prefix)
0x1234567890abcdef1234567890abcdef12345678Address summary data
Bad Request
Unauthorized
Payment Required
Forbidden
Not Found
Unprocessable Content
Too Many Requests
Internal Server Error
Bad Gateway
Service Unavailable
Gateway Timeout
POST /api/v1/prediction-market/address-summary HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 94
{
"address": "0x1234567890abcdef1234567890abcdef12345678",
"pagination": {
"page": 1,
"per_page": 10
}
}{
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": true
},
"data": [
{
"address": "text",
"first_seen": "2026-01-01",
"wallet_age_days": 1,
"realized_pnl_usd": 1,
"unrealized_pnl_usd": 1,
"total_pnl_usd": 1,
"markets_won": 1,
"markets_traded": 1,
"win_rate": 1,
"p2p_tokens_sent": 1,
"p2p_tokens_received": 1
}
]
}Last updated
Was this helpful?