{"uid":"cap_3TXaeL8EgihvZ776QVA9D","slug":"nansen-position-detail-9e7f6e25","name":"Nansen Prediction Market Position Detail","description":"Get detailed per-token position data for all holders in a specific prediction market.\nIncludes token balances, entry prices, current prices, and per-token PnL.\n\n**What it helps to answer:**\n\n1. **What are the exact positions of each holder in this market?**\n2. **What is the average entry price vs current price for each position?**\n3. **How much has each token position gained or lost?**","url":"https://api.nansen.ai/api/v1/prediction-market/position-detail?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"PositionDetailRequest","required":["market_id"],"properties":{"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 position detail endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"PositionDetailResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"PositionDetailItem","required":["market_id"],"properties":{"address":{"anyOf":[{"type":"string"}],"title":"Address","description":"Holder address (hex)"},"balance":{"anyOf":[{"type":"number"}],"title":"Balance","description":"Token balance"},"outcome":{"anyOf":[{"type":"string"}],"title":"Outcome","examples":["Yes"],"description":"Outcome label"},"event_id":{"anyOf":[{"type":"string"}],"title":"Event Id","description":"Parent event ID"},"token_id":{"anyOf":[{"type":"string"}],"title":"Token Id","description":"CLOB token ID"},"market_id":{"type":"string","title":"Market Id","examples":["654412"],"description":"Market ID"},"buy_tokens":{"anyOf":[{"type":"number"}],"title":"Buy Tokens","description":"Total tokens bought"},"event_title":{"anyOf":[{"type":"string"}],"title":"Event Title","description":"Parent event title"},"sell_tokens":{"anyOf":[{"type":"number"}],"title":"Sell Tokens","description":"Total tokens sold"},"buy_cost_usd":{"anyOf":[{"type":"number"}],"title":"Buy Cost Usd","description":"Total buy cost in USD"},"current_price":{"anyOf":[{"type":"number"}],"title":"Current Price","description":"Current price"},"outcome_index":{"anyOf":[{"type":"integer"}],"title":"Outcome Index","examples":[1],"description":"Outcome index"},"owner_address":{"anyOf":[{"type":"string"}],"title":"Owner Address","description":"SAFE proxy owner address (hex)"},"token_pnl_usd":{"anyOf":[{"type":"number"}],"title":"Token Pnl Usd","description":"Token PnL in USD"},"avg_entry_price":{"anyOf":[{"type":"number"}],"title":"Avg Entry Price","description":"Average entry price"},"market_resolved":{"anyOf":[{"type":"boolean"}],"title":"Market Resolved","description":"Whether market is resolved"},"sell_proceeds_usd":{"anyOf":[{"type":"number"}],"title":"Sell Proceeds Usd","description":"Total sell proceeds 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"}},"description":"Position detail data from ch_api_pm_position_detail."},"title":"Data","description":"List of position detail 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 position detail 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_Tb4z4pJAtdQp0W4qCnUf5","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 per-token position data for all holders in a specific Polymarket prediction market, including balances, entry prices, current prices, and PnL.","exampleAgentPrompt":"Show me all the holder positions for Polymarket market ID 654412 — I want to see each wallet's token balance, average entry price, current price, and their PnL in USD.","exampleUseCases":null,"resultDescription":"An array of position records, one per holder-token combination in the market. Each record includes the holder address, token balance, outcome label (e.g. Yes/No), average entry price, current market price, token PnL in USD, total buy cost, sell proceeds, redemption value, and whether the market is resolved. Supports pagination up to 1000 records per page.","failureModes":["Invalid or non-existent market_id returns empty data array","Market ID too long (>100 chars) or empty triggers validation error","Pagination page/per_page out of range returns 422 validation error","Payment not attached or insufficient USDC returns 402 Payment Required","Rate limiting or API key issues return 401/403 errors","Market with no holders returns empty data array"],"whenToPreferThis":"Use this endpoint when you need granular per-wallet, per-token position data for a specific Polymarket market — including entry price, current price, and individual PnL. Prefer this over market-level summary endpoints when you need to identify specific winning/losing wallets, analyze smart money positioning, or audit individual holder exposure in a prediction market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:46:12.173Z","isFirstParty":false,"canonicalSlug":"nansen-position-detail-9e7f6e25"}