List Games
Sports Discovery API
List Games
Compact game/outcome discovery view backed by canonical sports tables
GET
List Games
Overview
Returns broad sports games with canonical outcomes. This endpoint is the compact discovery view: venues are summarized at the game level, and each outcome exposes the canonicalpredexon_id used for routing and lookup.
For per-venue execution detail, prices, token IDs, condition IDs, and market titles, use GET /v2/sports/markets or GET /v2/sports/outcomes/{predexon_id}.
Query Parameters
Pagination
Sports list endpoints use cursor pagination. Pass the returnedpagination.pagination_key into the next request. Do not use offset-based pagination.
Response Fields
Game
Outcome
predexon_id is canonical across venues. The same team/draw outcome for the same game has one predexon_id, even when several venues list it./games is intentionally compact. It does not return venue-native identifiers. Use /markets for venue comparison and /outcomes/{predexon_id} for route resolution.Example
GET /v2/sports/games?league=mlb&limit=1
When to Use This vs /markets
Caching
Responses are cached for 60 seconds.Authorizations
Data key provided by Predexon. The trading key used by the Order Router on trade.predexon.com is a separate credential.
Query Parameters
Filter by sport.
Available options:
basketball, soccer, hockey, baseball Filter by league code (e.g. nba, epl).
Market status.
Available options:
open, closed Exact game date (YYYY-MM-DD).
Games on or after date (YYYY-MM-DD).
Games on or before date (YYYY-MM-DD).
Search game/market titles.
Sort order.
Available options:
game_date_asc, game_date_desc Max games to return.
Required range:
1 <= x <= 200Cursor from the previous response. Omit on the first request.
Response
200 - application/json
Successful response
