{"uid":"cap_aGgijDEk2lguwh8_JVX9t","slug":"polymarket-whale-holders-lookup-43fa3131","name":"Polymarket Whale Holders Lookup","description":"558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/polymarket-holders?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"slug":{"type":"string"},"limit":{"type":"integer","description":"1-20"}}},"responseSchema":{"type":"json","example":{"slug":"will-oprah-winfrey-win-the-2028-democratic-presidential-nomination","source":"Polymarket (public data API)","results":[{"result":"Yes","largest":[{"stakes":2441726.05,"wallet":"0x5d189e816b4149be00977c1a3c8840374aec4972"},{"stakes":81912.91,"wallet":"0xbefa95c276ee8ef6ff3ef43d1c1c454f52bc300d"}],"stakes_sum":2603019.75},{"result":"No","largest":[{"stakes":3132849.11,"wallet":"0xa5ef39c3d3e10d0b270233af41cac69796b12966"},{"stakes":231.63,"wallet":"0xd7508a67410adb7bb0004f5073dc285a750b5235"}],"stakes_sum":3133258.36}],"question":"Will Oprah Winfrey win the 2028 Democratic presidential nomination?"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_32utfViuJRPICiE9da9K0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the largest token holders for each outcome of a Polymarket prediction market, identified by wallet address and share count, plus a sum of the top holders' stakes.","exampleAgentPrompt":"Can you show me the top whale holders for each outcome of the Polymarket market with slug 'will-oprah-winfrey-win-the-2028-democratic-presidential-nomination'? Give me the top 5 holders.","exampleUseCases":[{"title":"Tracking whale bets on election markets","prompt":"Who are the biggest wallets betting Yes vs No on the 2028 US presidential election market on Polymarket? Use the slug 'us-presidential-election-winner-2028' and show me the top 10 holders per outcome."},{"title":"Detecting sentiment from large holders","prompt":"I want to see where the whales are leaning on the Polymarket market 'will-the-fed-cut-rates-in-2025' — show me the top 5 largest holders for each outcome so I can gauge smart-money sentiment."},{"title":"Checking holder concentration in a crypto market","prompt":"For the Polymarket market slug 'will-bitcoin-reach-200k-in-2025', can you pull the top 3 largest shareholders per outcome and tell me how much of the total stakes they control?"}],"resultDescription":"A JSON object containing the market slug, the question text, the data source (Polymarket public API), and an array of outcome results. Each outcome includes its label (e.g. 'Yes'/'No'), an ordered list of the largest holders with their wallet address and share count, and the combined stakes sum of all top holders for that outcome.","failureModes":["Invalid or non-existent slug returns an error or empty results","Limit value outside 1-20 range may cause a validation error","Polymarket market not yet resolved or very new may have sparse holder data","Rate limiting or payment failure (x402) if USDC balance is insufficient","Network timeout if Polymarket's public API is slow or unavailable"],"whenToPreferThis":"Use this endpoint when you need granular, wallet-level intelligence on who the largest bettors are in a specific Polymarket prediction market. It is ideal for smart-money analysis, whale tracking, and sentiment gauging via position concentration. Prefer this over generic Polymarket APIs when you specifically need top-N holder rankings per outcome with stake sums rather than aggregate market volume or price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:41:44.042Z","isFirstParty":false,"canonicalSlug":"polymarket-whale-holders-lookup-43fa3131"}