{"uid":"cap_--VNggfxNvw8UBXvohETW","slug":"polymarket-market-top-holders-by-condition-id-b96343d4","name":"Polymarket Market Top Holders by Condition ID","description":"Top holders of each outcome token for a Polymarket market (by conditionId): proxy wallet + position size. See who is on each side. Free Polymarket Data API. conditionId from market detail.","url":"https://proxy.suverse.io/v1/data/polymarket-market-holders","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o1iGcCj5ZY6N9iW_dljZf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","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 of each outcome token for a Polymarket prediction market, including proxy wallet addresses and position sizes by conditionId.","exampleAgentPrompt":"Who are the top holders of each outcome token for the Polymarket market with conditionId 0x1234abcd...? I want to see which proxy wallets have the biggest positions on the YES and NO sides.","exampleUseCases":[{"title":"Whale watching on a political prediction market","prompt":"Show me the top holders on each side of the Polymarket 2024 US election market — I have the conditionId, it's 0xabc123def456. I want to see which wallets are holding the most YES and NO tokens."},{"title":"Research market sentiment via large positions","prompt":"For the Polymarket market with conditionId 0x9f8e7d6c5b4a, can you pull the top outcome token holders and their position sizes? I want to understand if whales are concentrated on one side."},{"title":"Monitor top traders before a market resolves","prompt":"Right before this Polymarket market resolves, I want to see who the biggest players are on each outcome — can you get the top holders for conditionId 0x3c2b1a0f9e8d7c6b and show me their proxy wallet addresses and position sizes?"}],"resultDescription":"A list of top holders for each outcome token in the specified Polymarket market, including proxy wallet addresses and the size of their positions, broken down by outcome side (e.g. YES vs NO).","failureModes":["Invalid or unknown conditionId returns empty results or an error","Network timeout if Polymarket data is temporarily unavailable","Payment failure if x402 USDC payment is not properly authorized","Malformed request body returns a validation error","conditionId for an unresolved or delisted market may return incomplete data"],"whenToPreferThis":"Use this endpoint when you need on-chain holder data for a specific Polymarket prediction market outcome and have the conditionId. It is ideal for whale-watching, sentiment analysis via large positions, and tracking who is on each side of a market. Prefer this over general Polymarket APIs when you specifically need top-holder rankings with proxy wallet addresses and position sizes per outcome token.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:17:12.285Z","isFirstParty":false}