Get market holders
Holders
Get market holders
Retrieve holders of a market grouped by outcome, sorted by shares held. Identify the market with either condition_id or market_slug — exactly one must be provided. Set include_pnl=true to include a per-holder pnl object. Uses cursor-based pagination.
GET
Get market holders
Query Parameters
Market condition ID (0x-prefixed hex)
Market slug
Results limit per outcome (default: 10, max: 100)
Cursor-based pagination key
Minimum shares held (decimal string)
Maximum shares held (decimal string)
Include nested holder PnL data (default: false, +1 credit)
Response
Market holders grouped by outcome (sorted by shares DESC).
Response for market (condition_id) holders endpoint.
Last modified on June 17, 2026