⚽ World Cup 2026 Skill
FIFA World Cup 2026 data + the points-based prediction game. Script skill —
call the functions in core.skill_tools.worldcup from bash and read the JSON.
Auth is automatic (container JWT); no API key needed.
How to call
python3 -c "from core.skill_tools import worldcup; import json; print(json.dumps(worldcup.get_today_matches()))"
Every function returns a dict like {"success": true, "data": ...} (or
{"success": false, "error": ...} on failure).
When to use
- Matches — today / upcoming / live / finished, or one specific match.
- Predictions — place, cancel, or review prediction history.
- Stats — point balance, betting limits, win rate, total staked.
- Leaderboard — top predictors by points or accuracy.
Functions (from core.skill_tools import worldcup)
| Function |
Returns |
get_today_matches() |
today's matches + your prediction status |
get_upcoming_matches(limit=10) |
next scheduled matches |
get_live_matches() |
matches in progress now |
get_finished_matches(limit=20) |
recent results |
get_match_detail(match_id) |
one match in full |
place_bet(match_id, predict_type, prediction, stake) |
places a prediction |
cancel_prediction(prediction_id) |
cancels an unsettled prediction, refunds stake |
get_betting_status() |
point balance, pending stakes, min/max stake |
get_my_predictions(match_id=None, settled_only=False) |
your prediction history |
get_prediction_detail(prediction_id) |
one prediction in full |
get_my_stats() |
your win rate, total staked, etc. |
get_leaderboard(limit=50, sort_by="points") |
top predictors (sort_by: points|accuracy) |
Placing a bet — predict_type and prediction
prediction is a dict whose shape depends on predict_type. Fill ONLY the keys
for that type:
| predict_type |
prediction |
meaning |
win_draw_loss |
{"choice": "home"|"draw"|"away"} |
match result |
exact_score |
{"home": N, "away": N} |
exact final score |
total_goals |
{"range": "0-1"|"2-3"|"4+"} |
total goals bucket |
first_goal |
{"team": "TEAM_CODE"} |
which team scores first (e.g. BRA) |
stake = points to wager: multiple of 10, min 10, max 10000.
Recommended place_bet flow
get_betting_status() — confirm enough available points.get_match_detail(match_id) or get_today_matches() — confirm the match is open and get team codes (needed for first_goal).place_bet(match_id, predict_type, prediction, stake).- Read back the returned prediction ID to the user.
Example:
python3 -c "from core.skill_tools import worldcup; import json; print(json.dumps(worldcup.place_bet(42, 'win_draw_loss', {'choice':'home'}, 100)))"
Notes
- Points are the prediction-game currency, not real money — present as a game, never as financial advice.
cancel_prediction only works while a prediction is unsettled; it refunds the stake.- Match times are UTC; convert to the user's timezone when relevant.
1---2name: worldcup3description: FIFA World Cup 2026 — match schedules, live scores, results, and the prediction game (place/cancel bets with points, betting stats, leaderboard). Use whenever the user mentions the World Cup: today's / upcoming / live / finished matches, a specific match, placing or cancelling a prediction, staking points, their betting balance or win rate, or the predictor leaderboard.4---56# ⚽ World Cup 2026 Skill78FIFA World Cup 2026 data + the points-based prediction game. **Script skill** —9call the functions in `core.skill_tools.worldcup` from bash and read the JSON.10Auth is automatic (container JWT); no API key needed.1112## How to call1314```bash15python3 -c "from core.skill_tools import worldcup; import json; print(json.dumps(worldcup.get_today_matches()))"16```1718Every function returns a dict like `{"success": true, "data": ...}` (or19`{"success": false, "error": ...}` on failure).2021## When to use2223- **Matches** — today / upcoming / live / finished, or one specific match.24- **Predictions** — place, cancel, or review prediction history.25- **Stats** — point balance, betting limits, win rate, total staked.26- **Leaderboard** — top predictors by points or accuracy.2728## Functions (`from core.skill_tools import worldcup`)2930| Function | Returns |31|----------|---------|32| `get_today_matches()` | today's matches + your prediction status |33| `get_upcoming_matches(limit=10)` | next scheduled matches |34| `get_live_matches()` | matches in progress now |35| `get_finished_matches(limit=20)` | recent results |36| `get_match_detail(match_id)` | one match in full |37| `place_bet(match_id, predict_type, prediction, stake)` | places a prediction |38| `cancel_prediction(prediction_id)` | cancels an unsettled prediction, refunds stake |39| `get_betting_status()` | point balance, pending stakes, min/max stake |40| `get_my_predictions(match_id=None, settled_only=False)` | your prediction history |41| `get_prediction_detail(prediction_id)` | one prediction in full |42| `get_my_stats()` | your win rate, total staked, etc. |43| `get_leaderboard(limit=50, sort_by="points")` | top predictors (`sort_by`: points\|accuracy) |4445## Placing a bet — `predict_type` and `prediction`4647`prediction` is a dict whose shape depends on `predict_type`. Fill ONLY the keys48for that type:4950| predict_type | prediction | meaning |51|---|---|---|52| `win_draw_loss` | `{"choice": "home"\|"draw"\|"away"}` | match result |53| `exact_score` | `{"home": N, "away": N}` | exact final score |54| `total_goals` | `{"range": "0-1"\|"2-3"\|"4+"}` | total goals bucket |55| `first_goal` | `{"team": "TEAM_CODE"}` | which team scores first (e.g. `BRA`) |5657`stake` = points to wager: multiple of 10, min 10, max 10000.5859### Recommended place_bet flow601. `get_betting_status()` — confirm enough available points.612. `get_match_detail(match_id)` or `get_today_matches()` — confirm the match is open and get team codes (needed for `first_goal`).623. `place_bet(match_id, predict_type, prediction, stake)`.634. Read back the returned prediction ID to the user.6465Example:66```bash67python3 -c "from core.skill_tools import worldcup; import json; print(json.dumps(worldcup.place_bet(42, 'win_draw_loss', {'choice':'home'}, 100)))"68```6970## Notes71- Points are the prediction-game currency, not real money — present as a game, never as financial advice.72- `cancel_prediction` only works while a prediction is unsettled; it refunds the stake.73- Match times are UTC; convert to the user's timezone when relevant.
om-scogo