{"uid":"cap_n2SJW_L5MrdbRMtKmnSfv","slug":"nansen-6dcf76fa","name":"Nansen Prediction Market Position Detail","description":"Get Prediction Market Position Detail","url":"https://api.nansen.ai/api/v1/prediction-market/position-detail","method":"GET","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":["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_bywVC_XKTkZtvfreM7k_a","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":"Retrieves detailed position information for a specific prediction market, including holdings, exposure, and related analytics.","exampleAgentPrompt":"Pull up the full position detail on Nansen for the Polymarket market at contract address 0xabc123 — I want to see the breakdown of my holdings and exposure.","exampleUseCases":null,"resultDescription":"Returns detailed position information for a specified prediction market, including position size, exposure, holdings breakdown, and related on-chain analytics powered by Nansen's wallet labeling and smart money data.","failureModes":["Invalid or missing market identifier returns 400 error","Market address not found in Nansen database returns 404","Insufficient credits or unpaid x402 payment returns 402","Rate limiting or quota exceeded returns 429","Malformed POST body returns 400 validation error"],"whenToPreferThis":"Use this endpoint when you need granular position-level detail for a specific prediction market, especially when you want Nansen's smart money context layered on top of raw on-chain data. Prefer this over the Top Holders endpoint when you need a single position's full detail rather than a leaderboard view.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:39:48.831Z","isFirstParty":false}