Back to Details

worldcup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

⚽ World Cup 2026 Skill

⚽ 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.
FIFA世界杯2026数据 + 基于积分的预测游戏。脚本Skill—— 从bash中调用
core.skill_tools.worldcup
中的函数并读取JSON数据。 身份验证为自动完成（容器JWT）；无需API密钥。

How to call

调用方式

bash
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).
bash
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
)

函数（
from core.skill_tools import worldcup
）

FunctionReturns
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)
函数返回内容
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
可选：points|accuracy）

Placing a bet — 
predict_type
and 
prediction

投注操作——
predict_type
与
prediction

prediction
is a dict whose shape depends on 
predict_type
. Fill ONLY the keys for that type:
predict_typepredictionmeaning
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.
prediction
是一个字典，其结构取决于
predict_type
。仅需填写对应类型的键：
predict_typeprediction含义
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
= 投注积分：需为10的倍数，最低10，最高10000。

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.
Example:
bash
python3 -c "from core.skill_tools import worldcup; import json; print(json.dumps(worldcup.place_bet(42, 'win_draw_loss', {'choice':'home'}, 100)))"
  1. get_betting_status()
    ——确认有足够的可用积分。
  2. get_match_detail(match_id)
    或
    get_today_matches()
    ——确认赛事处于可投注状态，并获取球队代码（
    first_goal
    类型投注需要）。
  3. place_bet(match_id, predict_type, prediction, stake)
    。
  4. 将返回的预测ID告知用户。
示例：
bash
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.
  • 积分是预测游戏的虚拟货币，并非真实资金——需将其作为游戏呈现，绝不能作为财务建议。
  • cancel_prediction
    仅对未结算的预测生效；生效后会退还投注积分。
  • 赛事时间为UTC时区；相关时需转换为用户所在时区。