{"uid":"cap_f5qol3Ph3j2A5vR2_tuY9","slug":"api-nansen-ai-7fcac59a","name":"Nansen Prediction Market PnL by Market","description":"Get Prediction Market PnL by Market","url":"https://api.nansen.ai/api/v1/prediction-market/pnl-by-market","method":"GET","headers":{},"bodySchema":{"type":"object","title":"PnlByMarketRequest","required":["market_id"],"properties":{"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"SortOrder[PnlByMarketSortField]","required":["field","direction"],"properties":{"field":{"enum":["total_pnl_usd"],"type":"string","title":"PnlByMarketSortField","description":"Sortable fields for PnL by market 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"},"market_id":{"type":"string","title":"Market Id","examples":["654412"],"maxLength":100,"minLength":1,"description":"Polymarket market ID"},"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 market endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"PnlByMarketResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"PnlByMarketItem","required":["market_id"],"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":{"type":"string","title":"Market Id","examples":["654412"],"description":"Market ID"},"side_held":{"anyOf":[{"type":"string"}],"title":"Side Held","examples":["Yes"],"description":"Side held: Yes, No, or Both. Reflects last known position even if fully exited (unrealized_value_usd = 0). Null only if no buy activity on record."},"event_title":{"anyOf":[{"type":"string"}],"title":"Event Title","description":"Parent event title"},"owner_address":{"anyOf":[{"type":"string"}],"title":"Owner Address","description":"SAFE proxy owner address (hex)"},"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 market data from ch_api_pm_pnl_by_market."},"title":"Data","description":"List of PnL by market 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 market endpoint."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KJ7SPx6SshcOqsfj5sk5_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","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 broken down by prediction market for a given address or market identifier","exampleAgentPrompt":"Pull up the PnL breakdown by market for wallet 0xABC123 on Nansen's prediction market analytics — I want to see which markets were profitable and which were losses.","exampleUseCases":null,"resultDescription":"Returns structured PnL data organized by individual prediction market, including profit/loss figures, trade performance metrics, and net outcomes per market for the queried wallet or market scope.","failureModes":["Invalid or missing market/wallet identifier returns 400 error","No trading history for the given address in prediction markets returns empty results","Rate limiting or quota exceeded returns 429","Unsupported market identifier returns 404 or empty response","Payment not processed correctly via x402 returns 402"],"whenToPreferThis":"Use this endpoint when you need to understand financial performance (profit/loss) segmented by individual prediction market, rather than aggregate address-level PnL or raw trade data. Ideal for portfolio analysis, smart money tracking, and evaluating which specific prediction markets generated gains or losses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:58:34.827Z","isFirstParty":false}