Skills — finished outcome cards
Grounded, source-cited cards ready to put on air, publish or render in-app. Each costs 40 credits and is cached (calling again inside the cache window returns the same card instantly; pass force_regen: true to regenerate).
All fixture-scoped cards accept the natural-language combo: event or event_urn or team + opponent, plus optional date.
market-watch
POST /skills/market-watch · skill (40 credits) · ~20 min cache
Tournament-wide card: biggest market movers plus informational edge candidates, summarized.
| Body field | Type | Description |
|---|---|---|
force_regen | bool | bypass the cache and regenerate now |
fan-pulse
POST /skills/fan-pulse · skill (40 credits) · ~1 h cache
Social and news sentiment around a team, player or match — buzz, narratives, breaking news — via live X/web search.
| Body field | Type | Description |
|---|---|---|
event / event_urn / team + opponent / date | string | fixture or team scope |
query | string | free-text subject when no fixture/team |
lookback_hours | int | search window |
force_regen | bool | bypass the cache |
curl -X POST https://api.machina.gg/world-cup/v1/skills/fan-pulse \
-H "X-Api-Token: $KEY" -H "Content-Type: application/json" \
-d '{"team": "Morocco"}'match-preview
POST /skills/match-preview · skill (40 credits)
Grounded preview: form, key men, group context, market snapshot.
| Body field | Type | Description |
|---|---|---|
event / event_urn / team + opponent / date | string | the fixture |
force_regen | bool | bypass the cache |
match-recap
POST /skills/match-recap · skill (40 credits)
Post-match recap, authored once the final whistle blows — result, narrative, market settlement.
| Body field | Type | Description |
|---|---|---|
event / event_urn / team + opponent / date | string | the fixture |
force_regen | bool | bypass the cache |
player-spotlight
POST /skills/player-spotlight · skill (40 credits)
Grounded player card with performance context and narrative.
| Body field | Type | Description |
|---|---|---|
player | string | player name (e.g. "Vinicius Jr") |
team | string | the player's national team (disambiguates homonyms) |
player_urn | string | canonical URN (from /resolve) |
force_regen | bool | bypass the cache |
curl -X POST https://api.machina.gg/world-cup/v1/skills/player-spotlight \
-H "X-Api-Token: $KEY" -H "Content-Type: application/json" \
-d '{"player": "Vinicius Jr", "team": "Brazil"}'