GET /markets/active. You can filter by sport, league, event, market type, and more. To look up a specific market by hash, use GET /markets/find.
Fetch markets by sport
Pass one or moresportIds to scope results to a particular sport.
GET /sports to get a full list of sport IDs and their labels.
Fetch markets by league
Pass aleagueId to get all active markets in a specific league.
GET /leagues/active to get a full list of active league IDs.
Fetch markets by event
If you already have asportXeventId (returned on any market object), you can fetch all markets for that specific fixture.
Fetch a specific market by marketHash
If you have amarketHash, use GET /markets/find to retrieve it directly. You can pass up to 30 hashes in a single request.
GET /markets/find also returns settled markets, so it’s useful for looking up historical results.
Filters
Main lines only
For spread and total markets, multiple lines are usually available at once (e.g. over 1.5, 2.5, 3.5 goals). SetonlyMainLine=true to return only the primary line for each market type — the line where both sides are closest to 50/50.
Live markets only
SetliveOnly=true to return only markets currently available for in-play betting.
Filter by market type
Pass one or more market type IDs using thetype parameter to narrow results to a specific bet type.
type | Name |
|---|---|
1 | 1X2 (win / draw / no win) |
52 | 12 (moneyline, no draw) |
226 | 12 Including Overtime |
3 | Asian Handicap (spread) |
2 | Under/Over (totals) |
Pagination
GET /markets/active uses cursor-based pagination. Each response includes a nextKey field — pass it as paginationKey in your next request. Keep paginating until nextKey is absent or empty. Maximum pageSize is 50.
Real-time market updates
Rather than pollingGET /markets/active, subscribe to WebSocket channels to receive market changes as they happen. Three channels are relevant when working with markets:
| Channel | What you receive |
|---|---|
markets:global | Market status changes — new markets added, suspended, or settled |
main_line:global | Main line shifts on spread and totals markets |
fixtures:live_scores | Live score updates for a specific event |
