Skip to main content
GET
FIFA World Cup Live Games

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.
This is a REST discovery endpoint. Use the FIFA World Cup WebSocket for live streaming updates.
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:
Upcoming games:
Next page:
Keep the same status value when requesting the next page. Mock live game state:
Mock final game state:
When 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:
Completed games:
Completed games that ended within the last hour:
When 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

No games currently live:

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:
For final games after penalties, 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

This endpoint is display/discovery focused. It intentionally does not expose Polymarket CLOB token IDs, Predexon routing IDs, volume, or liquidity.

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

status
enum<string>
default:live

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.

Available options:
live,
upcoming,
ended,
all
mock
enum<string>

Optional deterministic mock live-state overlay for integration testing before FIFA games are live. Mutually exclusive with status.

Available options:
live,
final
limit
integer
default:100

Max games to return.

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

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

event_types
string

Optional comma-separated event-type filter for significant_events, e.g. score_change,red_card,yellow_card.

max_ended_age_seconds
integer

Return only completed games whose ended_at is not older than this many seconds.

Required range: x >= 0

Response

Successful response