worldcup

⚽ ワールドカップ 2026 スキル

FIFA ワールドカップ 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": ...} のような dict を返します（失敗時は {"success": false, "error": ...}）。

使用する場面

• 試合 — 今日 / 今後 / ライブ / 終了済み、または特定の 1 試合。
• 予想 — 予想の登録、キャンセル、予想履歴の確認。
• 統計 — ポイント残高、ベット上限、勝率、合計賭けポイント。
• リーダーボード — ポイントまたは的中率による上位予想者。

関数（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)	1 試合の詳細
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)	1 件の予想の詳細
get_my_stats()	あなたの勝率、合計賭けポイントなど
get_leaderboard(limit=50, sort_by="points")	上位予想者（sort_by: points|accuracy）

ベットの登録 — predict_type と prediction

prediction は predict_type に応じて形が変わる dict です。その型に対応するキー だけを埋めてください。

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 です。関連する場合はユーザーのタイムゾーンに変換してください。