worldcup

⚽ World Cup 2026 技能

FIFA World Cup 2026 数据 + 积分制预测游戏。脚本技能 — 通过 bash 调用 core.skill_tools.worldcup 中的函数并读取 JSON。 身份验证会自动完成（容器 JWT）；无需 API 密钥。

如何调用

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

每个函数都会返回一个字典，例如 {"success": true, "data": ...}（失败时为 {"success": false, "error": ...}）。

适用场景

• 比赛 — 今天的 / 即将开始的 / 正在进行的 / 已结束的比赛，或某场指定比赛。
• 预测 — 下注、取消或查看预测历史。
• 统计数据 — 积分余额、下注限额、胜率、总下注积分。
• 排行榜 — 按积分或准确率排名的顶尖预测者。

函数（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：points|accuracy）

下注 — predict_type 和 prediction

prediction 是一个字典，其结构取决于 predict_type。只填写该类型对应的键：

predict_type	prediction	含义
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。

推荐的 place_bet 流程

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 告知用户。

示例：

python3 -c "from core.skill_tools import worldcup; import json; print(json.dumps(worldcup.place_bet(42, 'win_draw_loss', {'choice':'home'}, 100)))"

注意事项

• 积分是预测游戏中的货币，不是真钱 — 请将其作为游戏呈现，切勿将其作为财务建议。
• cancel_prediction 仅适用于尚未结算的预测；取消后会退还下注积分。
• 比赛时间为 UTC；必要时请转换为用户所在时区。