FIFA World Cup Live Games
List FIFA World Cup game display data with Polymarket identifiers and live-state fields
Overview
Returns FIFA World Cup game-level display data for games covered by Predexon. This endpoint is for building an Explore or live-games page. It returns one object per FIFA World Cup game, including Polymarket-native identifiers, teams, scheduled start, display metadata, current live-state fields, and nested game-winner markets.status=live returns currently live covered FIFA World Cup games. If no covered game is live at request time, the response is a successful empty games array.Endpoint
Query Parameters
Status Filters
Example Requests
Current live games:status value when requesting the next page.
Mock live game state:
mock is provided, the endpoint uses real FIFA game, team, icon, identifier, and market metadata, then overlays deterministic synthetic live-state fields. This is intended for integration testing before any FIFA World Cup games are live.
Mock responses include the same response shape as normal responses, plus top-level mock: true and mock_scenario.
mock is mutually exclusive with status. Use status=live|upcoming|ended|all for real data, or mock=live|final for test data.
Filter key incidents:
max_ended_age_seconds is supplied, the returned games[] are completed games only. For example, status=all&max_ended_age_seconds=3600 returns only games with ended: true and an ended_at within the last hour.
Response Shape
Response Fields
Period and Clock
For FIFA World Cup game state,period is a normalized soccer match phase.
clock is a display clock for elapsed match time. It counts upward, not downward. It is minute-level, not second-level, and is formatted as values such as 18', 45+3', 67', or 120+1'.
clock can be null during scheduled, half-time, full-time, waiting, penalty-shootout, canceled, postponed, abandoned, suspended, or interrupted states.
The endpoint currently exposes the overall scheduled kickoff as scheduled_start. It does not expose separate first-half, second-half, extra-time, or penalty-shootout start timestamps. Clients should use period, status_text, clock, updated_at, and significant_events[] for phase display.
Penalty Shootouts
Penalty shootout score is separate from regular match score:score remains the match score and penalty_score shows the shootout result:
penalty_score is display metadata for the game state. Market resolution still follows each market’s rules.
Significant Events
significant_events[] contains normalized key incidents for the game when available. It is intended for display-level incidents such as goals, cards, substitutions, penalties, and game-end events, not every low-level stat.
last_play is the latest notable play for display. When present, it maps to the most recent item in significant_events[].
last_play can be null when no notable incident has happened yet, or when the live data source has not supplied a latest notable play for that game at that time. This does not mean the field is under development.
Use event_types to narrow the returned significant_events[] array. If omitted, all available event types are returned.
Common event types:
Pagination
Responses include cursor pagination:Market Fields
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 returned games. Use live for currently live games, upcoming for scheduled games, ended for completed games, or all for all covered FIFA World Cup games.
live, upcoming, ended, all Optional deterministic mock live-state overlay for integration testing before FIFA games are live. Mutually exclusive with status.
live, final Max games to return.
1 <= x <= 200Cursor returned from the previous response. Omit on the first request.
Optional comma-separated event-type filter for significant_events, e.g. score_change,red_card,yellow_card.
Return only completed games whose ended_at is not older than this many seconds.
x >= 0Response
Successful response
