{"uid":"cap_TuXzsSl0jgX39yNUNGn_U","slug":"arkham-x402-polymarket-top-holders-db1cb495","name":"Arkham x402 Polymarket Top Holders","description":"Get Arkham Polymarket top holders. $0.60 per call.","url":"https://api.arkm.com/x402/polymarket/top-holders","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 entries to return (1-100). Default: 20."},"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. Omit for all tokens."},"conditionId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Required. Polymarket condition ID for the market."}}},"responseSchema":{"type":"json","example":{"holders":[],"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_axY-3ate_9YK_jSyxsOwG","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":"Returns the top holders for a given Polymarket prediction market condition, with wallet intelligence from Arkham.","exampleAgentPrompt":"Who are the top holders for Polymarket condition 0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1? I want to see which wallets are most exposed to that market.","exampleUseCases":[{"title":"Whale tracking on prediction market","prompt":"Show me the top wallets holding positions on Polymarket condition 0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1 — I want to know if any big players are heavily exposed."},{"title":"Smart money signal for trading","prompt":"Before I take a position, can you pull the top holders for Polymarket condition 0xabc123... so I can see if any known smart money wallets are already in this market?"},{"title":"Research report on market concentration","prompt":"I'm writing a report on prediction market concentration — can you fetch the top holders list for Polymarket condition 0xdef456... so I can see how distributed the positions are?"}],"resultDescription":"A JSON object containing a list of top holder wallet addresses and their positions for the specified Polymarket conditionId, along with the conditionId itself for reference.","failureModes":["Invalid or unknown conditionId returns empty holders array","Malformed conditionId format causes request error","Insufficient USDC balance for x402 pay-per-request fails the call","Rate limiting or quota exceeded returns an error","Market condition not indexed by Arkham returns no data"],"whenToPreferThis":"Use this endpoint when you need on-chain wallet-level intelligence for a specific Polymarket prediction market, especially when you want to identify whale positions or smart money exposure. Prefer this over generic blockchain explorers when you need ranked, structured holder data enriched with Arkham's wallet identity layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:01:39.960Z","isFirstParty":false}