{"uid":"cap_nW6xzSSepEfwABJf9APw-","slug":"blockrun-ai-8e8a8f75","name":"BlockRun.AI Polymarket Top Holders","description":"Get top holders for a specific market ranked by position size","url":"https://blockrun.ai/api/v1/pm/polymarket/market/:hash/top-holders","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_vSF74GrwQ6LThu0bYK8Qu","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":"Returns the top holders for a specific Polymarket prediction market, ranked by position size","exampleAgentPrompt":"Who are the top holders in the Polymarket market with hash 0xabc123...? I want to see the biggest positions ranked by size.","exampleUseCases":null,"resultDescription":"A ranked list of the top wallet holders for the specified Polymarket market, including wallet addresses and their respective position sizes ordered from largest to smallest.","failureModes":["Invalid or non-existent market hash returns empty or error response","Market hash not found on Polymarket returns 404 or empty data","Payment not processed (x402 payment required) results in 402 error","Malformed hash parameter causes bad request error","Network timeout if Polymarket data is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need to identify the largest position holders (whales) in a specific Polymarket prediction market, identified by its market hash. Ideal for market analysis, tracking smart money, or understanding concentration of positions in a given prediction market event.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:05.960Z","isFirstParty":false}