{"uid":"cap_VB4YO8rLckFW_UZBjhirp","slug":"blockrun-ai-c336c2a0","name":"BlockRun.AI Polymarket Market Top Holders","description":"Returns the top holders for a specific Polymarket market, including wallet addresses, position sizes, values, PnL, trade counts, and pagination metadata.","url":"https://blockrun.ai/api/v1/pm/polymarket/market/0x0fb006e0c06caa4db12f7e30ec8c2483d658f83eb57b2ee8eb478e39beca3dfd/top-holders","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":{"type":"object","required":["_truncated","_originalSize"],"properties":{"_truncated":{"type":"boolean"},"_originalSize":{"type":"number"}}},"example":{"request":{"input":{"body":{}}},"response":{"_truncated":true,"_originalSize":44268}},"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.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cF95vj8mDHFxwdE0r2chf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"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, including wallet addresses, position sizes, values, PnL, and trade counts.","exampleAgentPrompt":"Show me the top holders for Polymarket market 0x0fb006e0c06caa4db12f7e30ec8c2483d658f83eb57b2ee8eb478e39beca3dfd — I want to see the biggest wallets, their position sizes, PnL, and trade counts.","exampleUseCases":null,"resultDescription":"A ranked list of top wallet holders for the specified Polymarket market, including each wallet address, position size in shares, position value in USD, realized and unrealized PnL, total trade count, and pagination metadata for navigating additional results.","failureModes":["Invalid or non-existent market contract address returns empty or error response","Market with no activity may return empty holder list","Rate limiting or payment failure (x402) if USDC balance is insufficient","Truncated response for very large holder sets requiring pagination","Network timeout for slow on-chain data retrieval"],"whenToPreferThis":"Use this endpoint when you need to identify the top position holders in a specific Polymarket prediction market by contract address, want to analyze whale activity or PnL leaders, or are building analytics around market concentration and trader behavior on Polymarket.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:02:54.559Z","isFirstParty":false}