{"uid":"cap_RXxqL6ogL0U3ypvxKq5fz","slug":"blockrun-polymarket-market-top-holders-1de62738","name":"BlockRun Polymarket Market Top Holders","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 115 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/pm/polymarket/market/0x0000000000000000000000000000000000000000000000000000000000000000/top-holders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0085","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.0085/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_URlm5juNSPNa8yQ8W3P_m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the top token holders for a specific Polymarket prediction market contract address","exampleAgentPrompt":"Who are the top holders for the Polymarket market at contract address 0xabc123...? I want to see which wallets control the biggest positions in that market.","exampleUseCases":[{"title":"Whale watching on prediction market","prompt":"Show me the top holders of the Polymarket market at contract 0xdef456... — I want to know which wallets have the biggest positions and might move the market."},{"title":"Validating market sentiment via holder distribution","prompt":"For the Polymarket market at address 0x789abc..., who are the largest token holders? I'm trying to understand if the market is concentrated in a few wallets or spread out."},{"title":"Tracking smart money in prediction markets","prompt":"Pull the top holders for Polymarket contract 0x123def... so I can see if any known sharp traders have big positions before I place my own bet."}],"resultDescription":"Returns a ranked list of the top token holders for the specified Polymarket prediction market, including wallet addresses and their respective holdings or position sizes within that market contract.","failureModes":["Invalid or zero-address contract address returns empty or error response","Contract address not found on Polymarket returns no data","Rate limiting or payment failure returns 402 payment required","Malformed address format causes request error","Market with no holders returns empty list"],"whenToPreferThis":"Use this endpoint when you need on-chain holder distribution data specifically for a Polymarket prediction market contract. Prefer this over general blockchain explorers when you want structured, ranked holder data for a prediction market without parsing raw chain data yourself. Best when you already have the Polymarket market contract address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:49:06.996Z","isFirstParty":false,"canonicalSlug":"blockrun-polymarket-market-top-holders-1de62738"}