{"uid":"cap_jtjzzMOklx8O-BZBSwsKF","slug":"vextorium-polymarket-whale-holders-736b8d78","name":"Vextorium Polymarket Whale Holders","description":"Largest holders of each outcome of a Polymarket market (by slug): wallet and shares, with the sum of the top holders. See where the whales are betting.","url":"https://api.vextorium.com/polymarket-holders-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["slug"],"properties":{"slug":{"type":"string"},"limite":{"type":"integer","description":"1-20"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"slug":{"type":["string","null"]},"fuente":{"type":["string","null"]},"pregunta":{"type":["string","null"]},"resultados":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"mayores":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"cartera":{"type":["null","string"]},"participaciones":{"type":["null","number"]}}}},"resultado":{"type":["null","string"]},"suma_participaciones":{"type":["null","number"]}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_C1jDIbV05Ol_0bkQH_hrr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the largest holders (by wallet and share count) for each outcome of a Polymarket prediction market, identified by its slug, plus the aggregate sum of top holder positions.","exampleAgentPrompt":"Show me the top 10 whale holders for each outcome of the Polymarket market with slug 'will-trump-win-the-2024-election' so I can see where the big money is betting.","exampleUseCases":[{"title":"Whale sentiment check before trading","prompt":"Before I put money into the Polymarket market 'will-fed-cut-rates-in-september', can you pull the top 5 largest holders for each outcome so I can see which side the whales are stacked on?"},{"title":"Research report on market concentration","prompt":"I need to analyze holder concentration on the Polymarket market 'bitcoin-above-100k-end-of-2024' — fetch the top 20 wallets and their share counts for each outcome and tell me the total shares the top holders control."},{"title":"Monitor whale positioning on a live market","prompt":"Check who the biggest holders are across all outcomes of the Polymarket slug 'who-will-win-2024-us-election' right now — I want the wallet addresses and share counts for the top 15 holders per outcome."}],"resultDescription":"Returns a JSON object containing the market slug, source, the market question, and an array of outcomes. Each outcome includes its label, an array of the top holder objects (wallet address and share count), and the sum of shares held by those top holders.","failureModes":["Invalid or non-existent slug returns null or empty results","Limit value outside 1-20 range may cause validation error","Polymarket data unavailability may result in empty resultados array","Network timeout if on-chain data is slow to fetch","Malformed request body returns an error"],"whenToPreferThis":"Use this endpoint when you need on-chain holder data for Polymarket prediction markets — specifically to identify whale wallets and their concentration per outcome. Prefer this over generic market APIs when you need per-wallet share breakdowns rather than just price or volume data, or when analyzing smart money positioning and market manipulation risk on Polymarket.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:42:01.059Z","isFirstParty":false,"canonicalSlug":"vextorium-polymarket-whale-holders-736b8d78"}