public-pm-data

Top holders per outcome of an event (Polymarket)

Keyless top holders of each outcome, read from Polymarket's public holder data on demand and never stored. Top 10 wallets per outcome by shares held, with average price (a probability 0-1), current value and realized/unrealized P&L in USD as Polymarket reports them. At most 10 markets per event are covered (live outcomes first, then by probability); marketsCovered < marketsTotal means a partial list. Cached 10 minutes.

The route takes NO query parameters: any query key answers 400. Every other venue answers 200 with available: false and a reason: venue_has_no_public_holders (Kalshi), venue_not_supported, market_ids_unavailable (market ids pruned, e.g. some time after resolution), or the transient venue_unavailable / busy (retry later). A single outcome whose venue call failed has available: false while the rest are served.

walletPagePath is the unlocalized path of CoinRithm's whale wallet page (/prediction-markets/whales/polymarket/<wallet>), set only when that page exists; otherwise null.

get/api/prediction-markets/events/{source}/{slug}/holders

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/prediction-markets/events/{source}/{slug}/holders
  • Auth: none required

Path parameters

source'polymarket' | 'kalshi' | 'rothera' | 'limitless' | 'smarkets' | 'manifold' | 'metaculus' | 'predictit' | 'futuur' | 'myriad' | 'forecastex' | 'gemini' required
slugstring required

Response

Holders per outcome, or available:false with a reason

sourcestring required
slugstring required
availableboolean required
reason'venue_has_no_public_holders' | 'venue_not_supported' | 'market_ids_unavailable' | 'venue_unavailable' | 'busy'

Present only when available is false.

provider'polymarket_data_api_v2'
asOfstring date-time
cacheTtlSecondsinteger
holdersPerOutcomeinteger
marketsCoveredinteger
marketsTotalinteger

Changes

No recorded changes to this operation across all 1 revision of this API.