REST API overview

Base URL : https://api.machina.gg/world-cup/v1
Auth     : X-Api-Token: <your key>     (header, every request)
Method   : POST for every endpoint — parameters go in the JSON body
OpenAPI  : https://machina.gg/world-cup-api/openapi.json

All endpoints are read-only and idempotent from your perspective (POST is used for ergonomic JSON bodies, not mutation). Responses share one envelope:

{ "data": { "..." : "endpoint payload" }, "meta": { "code": 200 }, "status": "success" }

The canonical flow

1. Discover — /get-schedule lists fixtures with their event_urn; /resolve maps any provider id or name to a canonical entity.
2. Context — standings, squads, injuries, enriched event context, markets.
3. Intelligence — model forecasts, backtests, market-move explanations.
4. Edge — signals and edge scans.
5. Cards — finished, source-cited outcome cards ready to publish.

Natural-language fixtures

Per-fixture endpoints accept either the precise event_urn or a natural event description ("Brazil vs Morocco") with optional team / opponent / date (YYYY-MM-DD) for disambiguation. Responses echo the resolved event_urn so your next call can chain on it.

Endpoint index

Endpoint	Class	Credits
/health	free	0
/get-schedule	data	1
/resolve	data	1
/get-event-context	data	1
/get-standings	data	1
/get-squads	data	1
/get-injuries	data	1
/get-player-performance-context	data	1
/search-markets	market	3
/get-market-state	market	3
/market-movers	market	3
/compare-market-sources	market	3
/fan-sentiment-context	social	8
/get-match-forecast	intelligence	12
/backtest-forecasts	intelligence	12
/explain-market-move	intelligence	12
/generate-market-brief	intelligence	12
/get-signal	edge	18
/find-market-edges	edge	18
/skills/market-watch	skill	40
/skills/fan-pulse	skill	40
/skills/match-preview	skill	40
/skills/match-recap	skill	40
/skills/player-spotlight	skill	40

Providers

Markets and reasoning are powered by Kalshi, Polymarket, Google Gemini and xAI Grok, fused with Machina's identity crosswalk and Dixon-Coles model layer.

Informational only

Everything this API returns is informational decision support — never betting advice or a guaranteed outcome.