{"uid":"cap_Zu1oAkWzlAAYAU5xWwYbH","slug":"blockrun-ai-fb250c4c","name":"BlockRun.AI Polymarket Top Holders","description":"Returns the top token holders for a specific Polymarket market.","url":"https://blockrun.ai/api/v1/pm/polymarket/market/0xd6591e966aebf061547ef34cdf3494ed318969887c8b7fb53f10ed5d5461a547/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":{"request":{"input":{"body":{}}},"response":{"_truncated":true,"_originalSize":44174}},"exampleRequest":{"input":{"body":{}}},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/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_BlOmikbaB0ciaosZ60jxN","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":"Show me the top holders ranked by position size for Polymarket market 0xd6591e966aebf061547ef34cdf3494ed318969887c8b7fb53f10ed5d5461a547 — I want to see which wallets have the biggest positions.","exampleUseCases":[{"title":"Monitor whale positions in election markets","prompt":"I'm tracking a presidential election prediction market on Polymarket. Can you show me the top holders ranked by their position size so I can see which whales are betting big on each outcome?"},{"title":"Analyze market concentration risk before trading","prompt":"Before I take a position on this Polymarket event, pull up the top position holders for me. I need to understand how concentrated the market is and whether a few large traders could move the price."},{"title":"Identify major traders in sports betting markets","prompt":"I'm interested in this Super Bowl prediction market on Polymarket. Show me who the largest bettors are ranked by their share amounts — I want to see what the smart money is doing."}],"resultDescription":"A ranked list of wallet addresses holding positions in the specified Polymarket market, ordered by position size, including share amounts and related position metadata for each top holder.","failureModes":["Invalid or unrecognized market contract address returns empty or error response","Market not tracked by BlockRun.AI returns no data","Response may be truncated for markets with very large holder sets (originalSize indicates full payload size)","Rate limiting or payment failure returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need on-chain holder distribution data for a specific Polymarket prediction market — particularly to identify whale positions, analyze market concentration, or monitor large traders. Prefer this over generic blockchain explorers when you want pre-ranked, Polymarket-specific position data without manual on-chain parsing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:52:01.730Z","isFirstParty":false}