Pro Data

モデルの数値を数分でコードに取り込む

156,421

データポイント

13 データセットにわたる 13,507 レコード、最大 148 フィールド。すべてモデル生成またはキュレーション済みで、毎日ソースから再構築。ここで自由に閲覧可能。無料キーで API から全データを取得できます。

48 nations1,215 players8,964 player-seasons958 match results

48カ国・104試合のすべての確率、予測スカッド、シーズン別選手キャリア、直近の結果、モデルに投入される対戦履歴を JSON または CSV で、あるいはアシスタントが呼び出せる MCP ツールとして提供。研究者、ファンタジープレイヤー、ジャーナリスト、アナリティクスチーム向け。以下のコマンド1つでライブエンドポイントを試せます。サインアップ不要。

早期アクセス提供中· 一括 zip + 過去データスライスは公開済み · 再現可能ノートブックと WC2018/WC2022 バックフィルはキックオフ前に公開予定

クイックスタート

今すぐ試す: サインアップ不要

これを実行してください。ライブモデルから優勝確率上位5チームを返します。アカウントも API キーも不要。 ?format=csv を追加するとテーブル形式で取得できます。

curl "https://onthepitch.now/api/v1/sample/"

全データが必要な場合（48チーム、全試合、選手、スカッド）: ログインし、 API キーを生成 (10 回の無料コール付き）、任意のエンドポイントに Bearer トークンとして渡します。

curl -H "Authorization: Bearer otp_live_…" \
  "https://onthepitch.now/api/v1/forecast/"

無料で試す: 10コール

ログインして API キーを生成 10 回の無料プログラムコールを利用できます。REST エンドポイントとホステッド MCP サーバーで共通。ノートブックやアシスタントにデータを接続して動作を確認するのに十分です。MCP ハンドシェイクはカウント対象外で、データコールのみカウントされます。Pro Pass は無制限です。

データの内容

インタラクティブ API リファレンスを見る →

13 データセット。各データセットは以下で取得可能: /api/v1/ as JSON or — with ?format=csv — a flat table. /api/v1/sample/ is public; the rest are gated (a Bearer API key or a Pro session cookie). Below is exactly what each one returns. Full schemas live in the interactive reference (OpenAPI 3.0 spec at /api/v1/openapi.json).

  • Tournament forecast

    48 nations

    /api/v1/forecast/

    Each nation's probability of lifting the trophy and of reaching every stage.

    返却値 · 17 fields Tournament-win probability · advance from group · reach R16 / QF / SF / final · win-group probability · P(finish 1st–4th in group) · confederation · FIFA rank · group

  • Team forecast trajectory

    480 snapshots

    /api/v1/team-history/

    How each team's forecast has moved over time — one row per daily build.

    返却値 · 7 fields Team · build timestamp · Elo rating · tournament-win probability · 90% CI band (low & high)

  • Match forecast

    104 matches

    /api/v1/fixtures/

    Win / draw / win plus match-event probabilities for every fixture in the bracket.

    返却値 · 25 fields P(home / draw / away) · expected goals each side · over 0.5 / 1.5 / 2.5 / 3.5 goals · both teams to score · clean-sheet probability each side · kickoff, venue & city · stage & group

  • Predicted squads

    1,246 players

    /api/v1/predicted-squads/

    Projected 26-man squad for every nation, one row per player.

    返却値 · 13 fields Starting-XI vs bench slot · position · jersey number · captain flag · international caps & goals · composite rating · rank within position

  • Player index

    1,215 players

    /api/v1/players/

    Career profile for every player in the modelling pool.

    返却値 · 9 fields Name · nation · position · current club & league · birth year · career goals & assists

  • Player season history

    8,964 player-seasons

    /api/v1/player-history/

    Season-by-season career record for every player — one row per player-season.

    返却値 · 12 fields Player · season · team & league · position · matches & minutes · goals & assists · xG & xAG

  • Anytime scorer

    50 ranked scorers

    /api/v1/anytime-scorer/

    Tournament scoring probabilities for the most likely goalscorers.

    返却値 · 15 fields P(scores ≥1 in the tournament) · expected matches played · per-stage scoring probability (group → final) · rank

  • Recent match results

    958 matches

    /api/v1/results/

    Every team's recent senior-international results — last 24 months, their POV.

    返却値 · 10 fields Date · opponent · home / away / neutral · goals for & against · result · competition

  • Head-to-head records

    144 pairings

    /api/v1/h2h/

    All-time record between each nation and its group-stage opponents.

    返却値 · 12 fields Meetings · wins / draws / losses · last-meeting date, score, tournament & winner

  • Major-tournament history

    106 tournament rows

    /api/v1/majors/

    Each nation's most-recent run at every major, with squad and coach continuity.

    返却値 · 15 fields Tournament & year · matches · W-D-L · goals for / against · bracket finish · coach (name, year appointed, still in charge) · squad-pool continuity · ?tournament=&year= slicing

  • Group schedule

    144 team-matchdays

    /api/v1/schedule/

    Every nation's three group-stage fixtures.

    返却値 · 7 fields Matchday · date · opponent · host city & country

  • Team list

    48 nations

    /api/v1/teams/

    The tournament field — the lookup table to join everything else on team_id.

    返却値 · 6 fields team_id · name · confederation · FIFA rank · host flag · group

  • Bulk snapshot

    One zip · ~3–5 MB

    /api/v1/bulk/snapshot/

    Every source file the site renders from, in a single download, with checksums.

    返却値 11 source JSONs + manifest (size, sha256 & built_at per file) · includes the deep fixture-enrichment blobs the per-endpoint variants flatten away

アクセス方法

上記のすべてのデータセットは公開の /api/v1/sample/ ティーザーを除きゲート付きです。Bearer API キーまたは Pro セッション Cookie で認証してください。データの取得方法の詳細は以下をご覧ください。

  • CSV variant on every endpoint

    公開中

    Pass ?format=csv on any endpoint for a tabular response, RFC-4180 quoted, suitable for spreadsheet or notebook import. All row types are flat — no nested JSON in CSV cells.

  • Daily refresh + provenance metadata

    公開中

    Every response carries the upstream snapshot's built_at timestamp in the envelope (JSON) or X-OnThePitch-Generated-At header (CSV). Pipeline refits daily; cache is private 1h.

  • Bulk snapshot download (zip)

    公開中

    GET /api/v1/bulk/snapshot/ returns one DEFLATE-compressed archive with the 11 source JSONs + a manifest (per-file size + sha256 + built_at). Includes the deep fixture enrichment blobs the per-endpoint variants flatten away. ~3–5 MB on the wire.

  • Historical tournament slicing

    公開中

    Pass ?tournament=&year= on /api/v1/majors/ to extract a single tournament-year — e.g. every WC2026 team's WC2022 row in one call. The dataset stores each team's most-recent appearance per tournament, so WC2022 covers most qualifiers; WC2018 only covers teams that haven't been at a WC since.

  • Long-lived API keys

    公開中

    Generate a Bearer key at /account/api-key/ and pass it as Authorization: Bearer otp_live_… on any endpoint — no cookie juggling for headless / CI / scheduled jobs. One key per account; reset it any time if it leaks.

  • MCP server — connect Claude / Cursor

    公開中

    A hosted Model Context Protocol server at /api/mcp exposes every endpoint as an MCP tool. Add it to Claude Code, Claude Desktop, or Cursor with one command and ask questions against the live model — no install, no glue code.

  • Backfilled model outputs — WC2018, WC2022

    近日公開

    Pre-tournament model probabilities for the last two World Cups, replayed against frozen inputs so you can backtest the model end-to-end against known outcomes. Requires re-pulling historical FBref / Wikipedia snapshots; tracked as a separate research initiative.

  • Reproducible notebooks

    近日公開

    Jupyter notebooks that fit the model end-to-end from the public data files and reproduce the website's outputs. Run locally with the published datasets.

使用例

今日からできる3つのこと

Set OTP_KEY to the API key you generate here (export OTP_KEY=otp_live_…) — one token, no cookie juggling, works the same from a shell, a notebook, or a scheduled job. (Signed in already? A Pro session cookie works too, but the key is the friendlier path.)

Full forecast as CSV

curl -H "Authorization: Bearer $OTP_KEY" \
  "https://onthepitch.now/api/v1/forecast/?format=csv" \
  -o forecast.csv

WC2022 historical slice

curl -H "Authorization: Bearer $OTP_KEY" \
  "https://onthepitch.now/api/v1/majors/?tournament=FIFA%20World%20Cup&year=2022" \
  -o wc2022.json

Bulk snapshot as a single zip

curl -H "Authorization: Bearer $OTP_KEY" \
  "https://onthepitch.now/api/v1/bulk/snapshot/" \
  -o onthepitch-snapshot-v1.zip

データを活用する

スナップショットを取得し、独自のモデルをフィッティング

一括 zip には、サイトで表示されるすべてのデータが含まれます: 予測、試合、予測スカッド、対戦成績、代表チームの大会履歴。ノートブックに読み込んで独自の分析を行うための3つのスターターレシピ。

1 · スナップショットを pandas に読み込む

zip を取得し、1回展開して各ファイルを DataFrame として読み込みます。予測データは1チーム1行のネスト構造です。以下でフラット化できます: pd.json_normalize.

import io, json, os, zipfile, requests, pandas as pd

z = zipfile.ZipFile(io.BytesIO(requests.get(
    "https://onthepitch.now/api/v1/bulk/snapshot/",
    headers={"Authorization": f"Bearer {os.environ['OTP_KEY']}"},
).content))

forecast = pd.json_normalize(
    json.loads(z.read("data.json"))["teams"],
)
fixtures = pd.json_normalize(
    json.loads(z.read("fixtures.json"))["fixtures"],
)
squads = pd.json_normalize(
    json.loads(z.read("predicted_squads.json"))["squads"],
    record_path="players",
    meta=["team_id"],
)

2 · ベースライン勝率モデルをフィッティング

予測スカッド + チーム予測から独自の H/D/A モデルを構築。総合評価 + スカッド戦力合計は妥当な開始特徴量セットです。公開確率と比較して、一致する点と異なる点を確認してください。

from sklearn.linear_model import LogisticRegression

# Aggregate predicted-XI composite to a team strength score.
xi = squads.query("slot == 'xi'")
strength = xi.groupby("team_id")["composite"].sum().rename("strength")

# Join strength onto fixtures and fit a logistic on prior tournament
# results (intl_majors.json has W/D/L from previous WCs + qualifiers).
intl = pd.json_normalize(
    json.loads(z.read("intl_majors.json"))["rows"],
)
features = intl.merge(strength, left_on="team_id", right_index=True)
X = features[["strength", "fifa_rank"]]
y = (features["finish"] >= 9).astype(int)  # 1 = quarter-final or better

clf = LogisticRegression().fit(X, y)
print(clf.coef_)

3 · 公開予測に対してモデルをキャリブレーション

独自のモデルがチームレベルの優勝確率を出力したら、Brier score と信頼性プロットで公開予測と比較できます。方法論ドキュメントで使用しているものと同じ指標です。

from sklearn.metrics import brier_score_loss

merged = forecast.merge(
    pd.Series(my_probs, name="my_p_win"),
    left_on="team_id", right_index=True,
)
print("OnThePitch Brier:", brier_score_loss(merged["won"], merged["p_win"]))
print("Yours        Brier:", brier_score_loss(merged["won"], merged["my_p_win"]))

Pass のライセンスはリサーチ利用です。フィッティング、バックテスト、結果の公開が可能です。 方法論ドキュメント への帰属表示は歓迎しますが必須ではありません。

エージェント

Claude、Cursor、または任意の MCP クライアントに接続

ホステッド Model Context Protocol サーバー（ /api/mcp ）がすべてのエンドポイントを MCP ツールとして公開します。アシスタント内でライブモデルに直接質問できます。インストールもグルーコードも不要。 API キー で認証してください。ログイン済みの任意のアカウントでキーを生成でき、最初の 10 回のツールコールは無料です。

Claude Code に追加

claude mcp add --transport http onthepitch \
  https://onthepitch.now/api/mcp \
  --header "Authorization: Bearer otp_live_…"

Then prompt naturally — “which team is most likely to win the group?”, “compare the projected XIs for France and England”, “how did Brazil do at WC2022?” — and the assistant calls the matching tool (get_forecast, get_predicted_squads, get_majors) and answers from the live data.

Pro Pass

Pro Pass で無制限アクセス

すべてのアカウントに API + MCP の無料コールが 10 回付きます。Pro Pass はワンタイム $35 で無制限アクセス: Standard Pass のすべてに加え、データエンドポイント、一括 zip ダウンロード、過去大会スライスが含まれます。再現可能ノートブックはキックオフ前に公開予定。Standard Pass をお持ちの場合、$20 でアップグレードできます。

Pro Pass を購入: $35 →

24h self-service refund·No subscription, no auto-renewal·Access through 31 Dec 2026. See refund policy.