{"uid":"cap_f9AxmrhmexLWYRYdFp5f9","slug":"nansen-a6f4af49","name":"Nansen Polymarket Wallet PnL Summary","description":"Get Prediction Market Address Summary","url":"https://api.nansen.ai/api/v1/prediction-market/address-summary","method":"GET","headers":{},"bodySchema":{"type":"object","title":"AddressSummaryRequest","required":["address"],"properties":{"address":{"type":"string","title":"Address","examples":["0x1234567890abcdef1234567890abcdef12345678"],"maxLength":100,"minLength":1,"description":"Wallet address (hex, with or without 0x prefix)"},"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."}},"description":"Request for address summary endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"AddressSummaryResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"AddressSummaryItem","properties":{"address":{"anyOf":[{"type":"string"}],"title":"Address","description":"Trader address (hex)"},"win_rate":{"anyOf":[{"type":"number"}],"title":"Win Rate","description":"Win rate (markets_won / markets_traded, 0-1)"},"first_seen":{"anyOf":[{"type":"string","format":"date"}],"title":"First Seen","description":"Date of first on-chain activity on Polygon"},"markets_won":{"anyOf":[{"type":"integer"}],"title":"Markets Won","description":"Number of markets with positive total PnL"},"total_pnl_usd":{"anyOf":[{"type":"number"}],"title":"Total Pnl Usd","description":"Total PnL (realized + unrealized) in USD"},"markets_traded":{"anyOf":[{"type":"integer"}],"title":"Markets Traded","description":"Total number of markets with fills"},"p2p_tokens_sent":{"anyOf":[{"type":"number"}],"title":"P2P Tokens Sent","description":"Total tokens sent via P2P transfers"},"wallet_age_days":{"anyOf":[{"type":"integer"}],"title":"Wallet Age Days","description":"Days since first on-chain activity"},"realized_pnl_usd":{"anyOf":[{"type":"number"}],"title":"Realized Pnl Usd","description":"Realized PnL in USD"},"unrealized_pnl_usd":{"anyOf":[{"type":"number"}],"title":"Unrealized Pnl Usd","description":"Unrealized PnL from open positions in USD"},"p2p_tokens_received":{"anyOf":[{"type":"number"}],"title":"P2P Tokens Received","description":"Total tokens received via P2P transfers"}},"description":"Address summary data from ch_api_pm_address_summary."},"title":"Data","description":"Address summary (single row)"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response for address summary endpoint."},"example":{"request":{"input":{"body":{"address":"0x1234567890123456789012345678901234567890"},"type":"http","method":"POST","bodyType":"json"}},"response":{"data":[{"address":"0x1234567890123456789012345678901234567890","win_rate":0,"first_seen":"2021-04-20","markets_won":0,"total_pnl_usd":0,"markets_traded":0,"p2p_tokens_sent":0,"wallet_age_days":1885,"realized_pnl_usd":0,"unrealized_pnl_usd":0,"p2p_tokens_received":0}],"pagination":{"page":1,"per_page":10,"is_last_page":true}}},"exampleRequest":{"address":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9fWTk82FiTZ-z2yyFyT9b","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns wallet-level PnL summary for a Polymarket trader including realized/unrealized PnL, win rate, and wallet age","exampleAgentPrompt":"Can you pull up the Polymarket performance summary for wallet 0x1234...abcd? I want to see their realized and unrealized PnL, win rate, and how long they've been trading.","exampleUseCases":null,"resultDescription":"Returns a wallet-level summary including realized PnL, unrealized PnL, win rate (markets won vs traded), and wallet age/start date for the specified Polymarket trader address.","failureModes":["Invalid or malformed wallet address returns an error response","Wallet address with no Polymarket activity may return empty or zero values","Network or upstream Nansen data unavailability results in 5xx errors","Payment failure (x402) if USDC balance is insufficient","Rate limiting if too many calls are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need a high-level performance overview of a specific Polymarket trader — including PnL, win rate, and wallet age — in a single call. Prefer this over the address PnL detail endpoint when a summary is sufficient and cost efficiency matters. Best for profiling individual traders, vetting smart money wallets, or quickly benchmarking a prediction market participant.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:14.696Z","isFirstParty":false}