{"uid":"cap_vMePkXK5clWqNwl5cYlc2","slug":"nansen-pnl-by-market-2dd804cf","name":"Nansen Prediction Market PnL by Market","description":"Get profit and loss breakdown for all traders in a specific prediction market.\nIncludes buy cost, sell proceeds, redemption values, and unrealized positions.\n\n**What it helps to answer:**\n\n1. **Who are the biggest winners and losers in this market?**\n2. **What is the PnL distribution across traders?**\n3. **How much unrealized value exists in open positions?**","url":"https://api.nansen.ai/api/v1/prediction-market/pnl-by-market?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"PnlByMarketRequest","required":["market_id"],"properties":{"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"PnlByMarketSortOrder","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":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n9IOK1f2RSlFF_mcI7avo","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns profit and loss breakdown for every trader in a specified Polymarket prediction market, including buy costs, sell proceeds, redemptions, and unrealized positions.","exampleAgentPrompt":"Show me the top 20 traders by total PnL in Polymarket market ID 654412, sorted from highest to lowest profit, so I can see who the biggest winners and losers are.","exampleUseCases":null,"resultDescription":"A paginated list of trader-level PnL records for the specified market, each containing the trader wallet address, SAFE proxy owner address, total PnL in USD, net buy cost, net sell proceeds, redemption value, unrealized value, the side held (Yes/No/Both), the market question, event title, and whether the market is resolved.","failureModes":["Missing required market_id returns a 422 validation error","Invalid or non-existent market_id returns an empty data array","Pagination out of bounds returns empty results","Per_page exceeding 1000 returns a validation error","Payment not included or insufficient returns a 402 Payment Required response","Malformed sort order object returns a 422 validation error"],"whenToPreferThis":"Use this endpoint when you need a full per-trader PnL breakdown for a specific Polymarket market — particularly when identifying top winners/losers, analyzing unrealized exposure, or building a trader leaderboard. Prefer this over general wallet PnL endpoints when the scope is a single prediction market and you need cross-trader comparison rather than a single wallet's history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:32:09.461Z","isFirstParty":false,"canonicalSlug":"nansen-pnl-by-market-2dd804cf"}