{"uid":"cap_JJGA8uWqFECadMMIWNDOC","slug":"arkham-x402-polymarket-event-positions-2ac7a39e","name":"Arkham x402 Polymarket Event Positions","description":"Get Arkham Polymarket event positions. $0.60 per call.","url":"https://api.arkm.com/x402/polymarket/event-positions","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Max results (default 50, max 1000)."},"maxPnl":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Maximum PnL in whole USD (can be negative)."},"minPnl":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Minimum PnL in whole USD (can be negative)."},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Offset for pagination (default 0)."},"sortBy":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. \"pnl\" (default), \"shares\", or \"value\"."},"outcome":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. 0 for Yes token, 1 for No token."},"maxValue":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Maximum current position value in whole USD."},"minValue":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Minimum current position value in whole USD."},"maxShares":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Maximum held shares (whole outcome-token shares)."},"minShares":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Minimum held shares (whole outcome-token shares)."},"sortOrder":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. \"asc\" or \"desc\" (default)."},"conditionId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Required. Polymarket condition ID."},"userAddresses":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to specific Polymarket trade addresses."},"tokenAddresses":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Explicit outcome token list; overrides condition-derived tokens and can span markets beyond the path conditio…"}}},"responseSchema":{"type":"json","example":{"positions":[{"pnl":"225636.626185","price":0,"value":"0","shares":"1043537.710844","outcome":"Yes","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/world-cup-winner-netherlands-flag-20260603-192743.png","question":"Will Netherlands win the 2026 FIFA World Cup?","conditionId":"0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1","totalTrades":7589,"userAddress":"0xB687f00464E33934f5d591F224E71C3559ecAeE5","tokenAddress":"0x7baa312d6393ea83c631fb77b47061651a2a9992c40fcac017009611d6a03df4"},{"pnl":"140074.249191","price":0,"value":"0","shares":"236907.947522","outcome":"Yes","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/world-cup-winner-netherlands-flag-20260603-192743.png","question":"Will Netherlands win the 2026 FIFA World Cup?","conditionId":"0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1","totalTrades":3025,"userAddress":"0xCbBa64CDDD05171925FFD05d8F8ABD38C83fDbFf","tokenAddress":"0x7baa312d6393ea83c631fb77b47061651a2a9992c40fcac017009611d6a03df4"}],"totalCount":43343,"conditionId":"0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","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.6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_enFtsVeNDVl2cnE69DudH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves wallet-level position data for a specific Polymarket prediction market event, including PnL, shares, outcome, and trader details.","exampleAgentPrompt":"Pull all wallet positions for the Polymarket event with condition ID 0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1 — I want to see who holds the most shares, their PnL, and how many trades each has made.","exampleUseCases":[{"title":"Whale tracking on prediction market","prompt":"Show me the largest wallets by PnL on the Polymarket event for 'Will Netherlands win the 2026 FIFA World Cup?' — I want to know who's making the most money and how many shares they hold."},{"title":"Market sentiment analysis via positions","prompt":"For the Polymarket condition ID 0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1, pull all the positions so I can see how the market is distributed across Yes and No outcomes."},{"title":"Investigating a specific trader's Polymarket exposure","prompt":"Look up all positions on that Polymarket event and tell me what wallet 0xB687f00464E33934f5d591F224E71C3559ecAeE5 is holding — their shares, PnL, and which outcome they bet on."}],"resultDescription":"Returns a paginated list of wallet positions for a Polymarket event, each containing the wallet address, outcome bet on (Yes/No), number of shares, current value, PnL, token address, condition ID, total number of trades, and an image URL for the market. Also includes a total count of all positions for the event.","failureModes":["Invalid or unknown conditionId returns empty results or 404","Malformed conditionId hex string causes request error","Event with no positions returns empty positions array","Rate limiting or payment failure (x402) if USDC payment not provided","Network timeout if Arkham backend is slow to respond"],"whenToPreferThis":"Use this endpoint when you need on-chain position-level data for Polymarket prediction market events — specifically to identify which wallets hold positions, their PnL, share counts, and outcomes. Prefer this over generic blockchain explorers when you want structured, pre-aggregated Polymarket position intelligence enriched with Arkham's wallet labeling. Best for agent workflows that analyze market sentiment, track whale behavior, or investigate specific trader exposure on Polymarket events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:49:48.870Z","isFirstParty":false}