{"uid":"cap_XEFkGpIROnNX9jjmF-oyi","slug":"api-nansen-ai-a238fbbb","name":"Nansen Prediction Market PnL by Address","description":"Get Prediction Market PnL by Address","url":"https://api.nansen.ai/api/v1/prediction-market/pnl-by-address","method":"GET","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":"SortOrder[PnlByAddressSortField]","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":["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_bomibeV2OVd2VOTqKUiNc","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 profit and loss (PnL) data for a specific wallet address across prediction markets","exampleAgentPrompt":"What's the total prediction market PnL for wallet address 0x1234abcd...? I want to see how much profit or loss they've made across all prediction markets.","exampleUseCases":null,"resultDescription":"Returns profit and loss breakdown for the specified wallet address across prediction markets, including realized and unrealized gains/losses, trade performance metrics, and net PnL figures.","failureModes":["Invalid or malformed wallet address returns 400 error","Address with no prediction market activity returns empty or zero PnL","Rate limiting or quota exceeded returns 429 error","Unsupported chain or address format returns error","Network timeout or service unavailability returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need to evaluate the prediction market trading performance of a specific wallet address — particularly for smart money analysis, portfolio tracking, or due diligence on a trader. Prefer this over general address PnL endpoints when the focus is specifically on prediction market positions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:54.576Z","isFirstParty":false}