Skip to main content
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 canonical predexon_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 returned pagination.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

x-api-key
string
header
required

Data key provided by Predexon. The trading key used by the Order Router on trade.predexon.com is a separate credential.

Query Parameters

sport
enum<string>

Filter by sport.

Available options:
basketball,
soccer,
hockey,
baseball
league
string

Filter by league code (e.g. nba, epl).

status
enum<string>
default:open

Market status.

Available options:
open,
closed
game_date
string

Exact game date (YYYY-MM-DD).

game_date_from
string

Games on or after date (YYYY-MM-DD).

game_date_to
string

Games on or before date (YYYY-MM-DD).

Search game/market titles.

sort_by
enum<string>
default:game_date_asc

Sort order.

Available options:
game_date_asc,
game_date_desc
limit
integer
default:50

Max games to return.

Required range: 1 <= x <= 200
pagination_key
string

Cursor from the previous response. Omit on the first request.

Response

200 - application/json

Successful response