{"uid":"cap_3oSRZWpZmouck6CQxYUz7","slug":"polymarket-top-holders-by-outcome-predict-holders-4e8800eb","name":"Polymarket Top Holders by Outcome (predict.holders)","description":"Top holders of a Polymarket market, grouped by outcome token (conditionId). Each holder: wallet, trader name, position size, outcome index, and verified flag. Reveals concentration and smart-money positioning per outcome — the holder-side complement to predict.trades (flow) and predict.whales (large trades). Read-only from Polymarket's Data API.","url":"https://2s.io/api/predict/holders","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["market"],"properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Top holders per outcome (default 20)."},"market":{"type":"string","maxLength":80,"minLength":8,"description":"Market conditionId (0x…) — from predict.markets / predict.market."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TqPfsZl80k_3g-yehAr2G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top token holders for a Polymarket prediction market, grouped by outcome, including wallet, trader name, position size, outcome index, and verified status.","exampleAgentPrompt":"Show me the top 20 holders for each outcome on the Polymarket market with conditionId 0x1234abc… — I want to see wallet addresses, trader names, position sizes, and which ones are verified.","exampleUseCases":null,"resultDescription":"A list of top token holders per outcome for the specified Polymarket market. Each entry includes the wallet address, trader display name, position size in the outcome token, the outcome index (e.g. 0 for YES, 1 for NO), and a verified flag indicating whether the trader is a known/verified participant. Results are grouped by outcome token, revealing concentration and smart-money positioning on each side of the market.","failureModes":["Invalid or malformed conditionId returns an error (must be 0x-prefixed hex, 8-80 chars)","Market not found on Polymarket returns empty or 404-style response","Limit out of range (must be 1-100) returns validation error","Payment not completed (x402 flow) results in 402 Payment Required response","Stale data if Polymarket Data API is lagging behind chain state"],"whenToPreferThis":"Use this endpoint when you need to understand holder-side concentration and positioning in a Polymarket market — i.e., who holds the most of each outcome token right now. Prefer this over predict.trades (which shows order flow) or predict.whales (which surfaces large individual trades) when the question is about current ownership distribution, smart-money accumulation, or whether a small number of wallets dominate one side of a market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:07:04.007Z","isFirstParty":false}