{"uid":"cap_6YEjjYgSuQYw8n8zktu0H","slug":"nansen-pnl-summary-9a7d77c8","name":"Nansen PnL Summary","description":"Get aggregate PnL statistics and top profitable tokens for a specific wallet address.\nThis endpoint provides comprehensive profit and loss analysis including realized PnL, win rate, and top performing tokens.","url":"https://api.nansen.ai/api/v1/profiler/address/pnl-summary?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"ProfilerAddressPnlSummaryRequest","examples":[{"date":{"to":"2025-05-03T23:59:59Z","from":"2025-05-01T00:00:00Z"},"chain":"ethereum","wallet_address":"0x39d52da6beec991f075eebe577474fd105c5caec"},{"date":{"to":"2025-05-03T23:59:59Z","from":"2025-05-01T00:00:00Z"},"chain":"ethereum","entity_name":"Vitalik Buterin"}],"required":["chain","date"],"properties":{"date":{"type":"object","title":"DateRange","properties":{"to":{"anyOf":[{"type":"string"}],"title":"To","examples":["2025-01-31T23:59:59Z"],"description":"End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"},"from":{"anyOf":[{"type":"string"}],"title":"From","examples":["2025-01-01T00:00:00Z"],"description":"Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"}},"description":"Date range model matching the API schema."},"chain":{"enum":["all","arbitrum","arc","avalanche","base","bnb","ethereum","linea","mantle","monad","optimism","plasma","polygon","robinhood","sei","solana","sonic","sui"],"type":"string","title":"ProfilerPnLChain","description":"Chains supported in profiler PnL analysis."},"address":{"anyOf":[{"type":"string"}],"title":"Address","deprecated":true,"description":"Deprecated: Use 'wallet_address' instead. Alias of `wallet_address`. If you send both fields, they must contain the same address."},"entity_name":{"anyOf":[{"type":"string"}],"title":"Entity Name","examples":["Vitalik Buterin","Binance"],"description":"Entity name to get PnL summary for"},"wallet_address":{"anyOf":[{"type":"string"}],"title":"Wallet Address","examples":["0x39d52da6beec991f075eebe577474fd105c5caec","8zFZHuSRuDpuAR7J6FzwyF3vKNx4CVW3DFHJerQhc7Zd"],"description":"Wallet address to get PnL summary for"}},"description":"","additionalProperties":false},"responseSchema":{"type":"object","title":"ProfilerAddressPnlSummaryResponse","required":["pagination","top5_tokens","traded_token_count","traded_times","realized_pnl_usd","realized_pnl_percent","win_rate"],"properties":{"win_rate":{"type":"number","title":"Win Rate","description":"Number of sales where price of the token was higher than cost basis"},"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."},"top5_tokens":{"type":"array","items":{"type":"object","title":"ProfilerTopToken","required":["realized_pnl","realized_roi","token_address","token_symbol","chain"],"properties":{"chain":{"type":"string","title":"Chain","description":"Blockchain chain"},"realized_pnl":{"anyOf":[{"type":"number"}],"title":"Realized Pnl","description":"Realized profit and loss in USD"},"realized_roi":{"anyOf":[{"type":"number"}],"title":"Realized Roi","description":"Realized return on investment as percentage"},"token_symbol":{"type":"string","title":"Token Symbol","description":"Token symbol"},"token_address":{"type":"string","title":"Token Address","description":"Token contract address"}},"description":"Individual top token record for PnL summary.\n\nRepresents a top profitable token from the wallet's trading history."},"title":"Top5 Tokens","description":"Top 5 tokens by realized profit"},"traded_times":{"type":"integer","title":"Traded Times","description":"Total number of sales (outflow or dex sell)"},"realized_pnl_usd":{"type":"number","title":"Realized Pnl Usd","description":"Total realized profit and loss in USD"},"traded_token_count":{"type":"integer","title":"Traded Token Count","description":"Total number of different tokens that have been bought or sold"},"realized_pnl_percent":{"type":"number","title":"Realized Pnl Percent","description":"Realized profit and loss as a percentage (not multiplied by 100)"}},"description":"Response model for profiler address pnl-summary endpoint.\n\nContains aggregate PnL statistics and top profitable tokens."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ce5wIxAQzTxRxGsSUDNFO","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_UeV_W9dWPNmCPq5zgcpG8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns aggregate profit/loss statistics and top 5 profitable tokens for a wallet address or named entity over a specified date range and chain.","exampleAgentPrompt":"Can you pull the Nansen PnL summary for wallet 0x39d52da6beec991f075eebe577474fd105c5caec on Ethereum from May 1 to May 3, 2025 — I want to see their realized profit, win rate, and top tokens?","exampleUseCases":null,"resultDescription":"Returns total realized PnL in USD, realized PnL percentage, win rate (fraction of profitable sales), total traded token count, total number of trades, and an array of the top 5 tokens by realized profit including each token's symbol, contract address, chain, realized PnL in USD, and realized ROI percentage. Also includes pagination metadata.","failureModes":["Invalid or unrecognized wallet address returns error","Unsupported chain value returns validation error","Missing required fields (chain or date) returns 400 bad request","Date range with no trading activity returns zero values","Entity name not found in Nansen database returns error","Date range too broad may result in slow or truncated response","Payment not completed returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need a rolled-up performance summary for a specific wallet — realized profits, win rate, trade count, and best-performing tokens — over a custom date range on a specific chain. Prefer this over individual trade lookups when the goal is a high-level performance snapshot rather than raw transaction detail. Ideal for smart money tracking, whale wallet analysis, or comparing trader performance across time periods.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:41:08.047Z","isFirstParty":false,"canonicalSlug":"nansen-pnl-summary-9a7d77c8"}