{"uid":"cap_jEZZZQw-VBc46j3T83J7a","slug":"nansen-pnl-by-address-93f90f8a","name":"Nansen Prediction Market PnL by Address","description":"Get profit and loss across all prediction markets for a specific wallet address.\nShows per-market PnL including buy costs, sell proceeds, and redemption values.\n\n**What it helps to answer:**\n\n1. **What is a trader's total PnL across all prediction markets?**\n2. **Which markets has this address traded, and what were the results?**\n3. **Does this trader have unrealized positions?**","url":"https://api.nansen.ai/api/v1/prediction-market/pnl-by-address?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"PnlByAddressRequest","required":["address"],"properties":{"address":{"type":"string","title":"Address","examples":["0x1234567890abcdef1234567890abcdef12345678"],"maxLength":100,"minLength":1,"description":"Wallet address (hex, with or without 0x prefix)"},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"PnlByAddressSortOrder","required":["field","direction"],"properties":{"field":{"enum":["total_pnl_usd"],"type":"string","title":"PnlByAddressSortField","description":"Sortable fields for PnL by address endpoint."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","examples":[[{"field":"total_pnl_usd","direction":"DESC"}]],"description":"Sort order"},"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 PnL by address endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"PnlByAddressResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"PnlByAddressItem","properties":{"address":{"anyOf":[{"type":"string"}],"title":"Address","description":"Trader address (hex)"},"event_id":{"anyOf":[{"type":"string"}],"title":"Event Id","description":"Parent event ID"},"question":{"anyOf":[{"type":"string"}],"title":"Question","description":"Market question"},"market_id":{"anyOf":[{"type":"string"}],"title":"Market Id","description":"Market ID"},"side_held":{"anyOf":[{"type":"string"}],"title":"Side Held","examples":["Yes"],"description":"Side held (Yes/No)"},"event_title":{"anyOf":[{"type":"string"}],"title":"Event Title","description":"Parent event title"},"total_pnl_usd":{"anyOf":[{"type":"number"}],"title":"Total Pnl Usd","description":"Total PnL in USD"},"market_resolved":{"anyOf":[{"type":"boolean"}],"title":"Market Resolved","description":"Whether market is resolved"},"net_buy_cost_usd":{"anyOf":[{"type":"number"}],"title":"Net Buy Cost Usd","description":"Net buy cost in USD"},"redemption_value_usd":{"anyOf":[{"type":"number"}],"title":"Redemption Value Usd","description":"Redemption value in USD"},"unrealized_value_usd":{"anyOf":[{"type":"number"}],"title":"Unrealized Value Usd","description":"Unrealized value in USD"},"net_sell_proceeds_usd":{"anyOf":[{"type":"number"}],"title":"Net Sell Proceeds Usd","description":"Net sell proceeds in USD"}},"description":"PnL by address data from ch_api_pm_pnl_by_address."},"title":"Data","description":"List of PnL by address records"},"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 PnL by address endpoint."},"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_nq7TmMtcbL4TSlrNgkVd2","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_ottfRurMdXN-srAhowJDf","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 per-market profit and loss breakdown for a specific wallet address across all prediction markets, including buy costs, sell proceeds, redemption values, and unrealized positions.","exampleAgentPrompt":"Pull up the prediction market PnL breakdown for wallet 0x1234567890abcdef1234567890abcdef12345678 — show all markets they've traded sorted by total PnL from highest to lowest, including any unrealized positions.","exampleUseCases":null,"resultDescription":"A paginated list of per-market PnL records for the wallet, each containing the market question, event title, side held (Yes/No), net buy cost in USD, net sell proceeds in USD, redemption value in USD, unrealized value in USD, total PnL in USD, and whether the market is resolved. Includes pagination metadata.","failureModes":["Invalid or malformed wallet address returns a validation error","Address with no prediction market activity returns an empty data array","Invalid sort field or direction in order_by causes a 422 validation error","Pagination page/per_page out of range returns a 422 error","Rate limit exceeded or missing/invalid API key returns 401 or 429"],"whenToPreferThis":"Use this endpoint when you need to evaluate a specific wallet's trading performance and profitability across prediction markets, especially for smart money analysis, trader profiling, or identifying which markets a wallet has been active in. Prefer this over general DEX or token PnL endpoints when the focus is specifically on prediction market positions and outcomes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:48.750Z","isFirstParty":false,"canonicalSlug":"nansen-pnl-by-address-93f90f8a"}