{"uid":"cap_qxikRoEXwqPRRPzavQFFY","slug":"aisa-mpp-data-apis-polymarket-top-holders-31156518","name":"Polymarket Top Holders","description":"Get top holders for one or more markets.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.00044 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/polymarket/holders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["market"],"properties":{"limit":{"type":"integer","default":20,"maximum":20,"minimum":0,"description":"Maximum number of holders to return per token. Capped at 20."},"market":{"type":"array","items":{"type":"string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","description":"0x-prefixed 64-hex string"},"description":"Comma-separated list of condition IDs."},"minBalance":{"type":"integer","default":1,"maximum":999999,"minimum":0}}},"responseSchema":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"holders":{"type":"array","items":{"type":"object","properties":{"bio":{"type":"string"},"name":{"type":"string"},"asset":{"type":"string"},"amount":{"type":"number"},"pseudonym":{"type":"string"},"proxyWallet":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"User Profile Address (0x-prefixed, 40 hex chars)"},"outcomeIndex":{"type":"integer"},"profileImage":{"type":"string"},"displayUsernamePublic":{"type":"boolean"},"profileImageOptimized":{"type":"string"}}}}}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.00044","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.00044/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.00044","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.00044","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i2aq2KUwoIEBw99ErAJvp","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.00044","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Returns the top token holders for one or more Polymarket prediction market condition IDs, including wallet info, position amounts, and profile details.","exampleAgentPrompt":"Who are the top 10 holders for the Polymarket market with condition ID 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917? Only show wallets with a balance of at least 50 tokens.","exampleUseCases":[{"title":"Whale watching on a political market","prompt":"Who are the top 20 holders for the Polymarket condition 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917? I want to see who's betting the most on this election outcome."},{"title":"Tracking holder concentration across multiple markets","prompt":"Can you pull the top holders for these two Polymarket conditions — 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917 and 0xabc1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd — and show me anyone holding at least 100 tokens?"},{"title":"Identifying influential traders before a market resolves","prompt":"Show me the top 5 wallets with the biggest positions in Polymarket market 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917 so I can see if any known traders are heavily weighted on one side."}],"resultDescription":"An array of objects, one per token in the queried markets. Each object contains the token identifier and a list of top holders sorted by position size. Each holder entry includes their proxy wallet address, display name or pseudonym, bio, profile image URLs, token asset, amount held, outcome index, and whether their username is publicly visible.","failureModes":["Missing or malformed condition ID (not 0x-prefixed 64 hex chars) returns a validation error","Requesting more than 20 holders per token is capped at 20","No holders meeting the minBalance threshold returns an empty holders array","Invalid market condition ID that doesn't exist on Polymarket may return empty results","Network or upstream Polymarket API outage may cause timeout or 5xx error"],"whenToPreferThis":"Use this endpoint when you need on-chain holder distribution data for specific Polymarket prediction markets — e.g. to identify whale wallets, measure position concentration, or profile large traders. Prefer this over a general leaderboard endpoint when you have specific condition IDs and want per-market holder breakdowns rather than global rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:52:38.693Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-top-holders-31156518"}