{"uid":"cap_ObjCO9iM3tD3tVtb-tO1i","slug":"api-nansen-ai-f139934d","name":"Nansen Address PnL Summary","description":"Get Address PnL Summary Data","url":"https://api.nansen.ai/api/v1/profiler/address/pnl-summary","method":"GET","headers":{},"bodySchema":{"type":"object","title":"ProfilerAddressPnlSummaryRequest","examples":[{"date":{"to":"2025-05-03T23:59:59Z","from":"2025-05-01T00:00:00Z"},"chain":"ethereum","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","avalanche","base","bnb","ethereum","linea","mantle","monad","optimism","plasma","polygon","ronin","scroll","sei","solana","sonic"],"type":"string","title":"ProfilerPnLChain","description":"Chains supported in profiler PnL analysis."},"address":{"anyOf":[{"type":"string"}],"title":"Address","examples":["0x39d52da6beec991f075eebe577474fd105c5caec","8zFZHuSRuDpuAR7J6FzwyF3vKNx4CVW3DFHJerQhc7Zd"],"description":"Address to get PnL summary for"},"entity_name":{"anyOf":[{"type":"string"}],"title":"Entity Name","examples":["Vitalik Buterin","Binance"],"description":"Entity name 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":["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_KDq7PpnDrKioVy10YF_gr","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 a summarized profit and loss breakdown for a given blockchain address using Nansen's wallet analytics data","exampleAgentPrompt":"Pull up the Nansen PnL summary for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see their overall profit and loss performance.","exampleUseCases":[{"title":"Evaluate smart money wallet quality","prompt":"Can you pull the PnL summary for 0xabcdef1234567890abcdef1234567890abcdef12? I want to know if this wallet is consistently profitable or if they're a net loser overall."},{"title":"Check DeFi trader overall returns","prompt":"Look up the profit and loss summary for wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e — I'm trying to get a sense of their total realized gains, win rate, and top performing tokens before deciding whether to follow their trades."},{"title":"Assess portfolio ROI for address","prompt":"Get me the Nansen PnL breakdown for 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8. I want to see their overall return on investment and whether their unrealized gains are looking healthy right now."}],"resultDescription":"Returns an aggregated PnL summary for the given address, including realized and unrealized gains/losses, total return metrics, and trade performance data sourced from Nansen's on-chain wallet analytics.","failureModes":["Invalid or malformed address returns a 400 error","Address not found or no data available returns empty result or 404","Rate limiting or quota exceeded returns a 429 error","Network or upstream data service unavailable returns 503","Unparseable address format causes validation error"],"whenToPreferThis":"Use this endpoint when you need a high-level financial performance summary for a blockchain address, particularly when evaluating whether a wallet is a net winner or loser. Prefer this over the detailed PnL endpoint when you want a concise aggregated view rather than individual trade-level data. Ideal for quickly profiling 'smart money' wallets or assessing trader quality.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:53:09.886Z","isFirstParty":false}