⚽ World Cup 2026 Skill

core.skill_tools.worldcup

How to call

python3 -c "from core.skill_tools import worldcup; import json; print(json.dumps(worldcup.get_today_matches()))"

{"success": true, "data": ...}

{"success": false, "error": ...}

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

)

get_today_matches()

get_upcoming_matches(limit=10)

get_live_matches()

get_finished_matches(limit=20)

get_match_detail(match_id)

place_bet(match_id, predict_type, prediction, stake)

cancel_prediction(prediction_id)

get_betting_status()

get_my_predictions(match_id=None, settled_only=False)

get_prediction_detail(prediction_id)

get_my_stats()

get_leaderboard(limit=50, sort_by="points")

sort_by

Placing a bet —

predict_type

and

prediction

prediction

predict_type

win_draw_loss

{"choice": "home"|"draw"|"away"}

exact_score

{"home": N, "away": N}

total_goals

{"range": "0-1"|"2-3"|"4+"}

first_goal

{"team": "TEAM_CODE"}

BRA

stake

Recommended place_bet flow

1. get_betting_status()

   — confirm enough available points.

2. get_match_detail(match_id)

   or

   get_today_matches()

   — confirm the match is open and get team codes (needed for

   first_goal

   ).

3. place_bet(match_id, predict_type, prediction, stake)

   .
4. Read back the returned prediction ID to the user.

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.