過去オッズでバックテストとモデル構築を
選んだブックメーカーの締切オッズを、最終スコア付きで取得できます。リーグの1シーズン分を数回のリクエストで、あるいは1イベントずつ、ライブオッズと同じAPIキーで取得できます。
- 締切オッズの提供開始
- 2025年12月
- 一括リクエストあたり
- 366日
- リクエストあたりのブックメーカー数
- 30
- リクエストあたりのリーグ数
- 10
1か月分の締切オッズを1回のリクエストで
/v3/historical/closing-linesは、期間内の確定済みイベントをすべて、締切オッズと最終スコア付きで返します。選んだブックメーカーのオッズがないイベントも空のbookmakersオブジェクト付きで返されるため、オッズの欠落が試合の欠落に見えることはありません。
curl "https://api.odds-api.io/v3/historical/closing-lines?apiKey=YOUR_API_KEY\
&sport=football&leagues=england-premier-league,spain-la-liga\
&from=2026-01-01T00:00:00Z&to=2026-01-31T23:59:59Z\
&markets=ML&bookmakers=Bet365,Unibet&limit=100"[
{
"id": 123456,
"home": "Arsenal",
"away": "Chelsea",
"date": "2026-01-14T20:00:00Z",
"status": "settled",
"league": { "name": "England - Premier League", "slug": "england-premier-league" },
"scores": { "home": 2, "away": 1 },
"bookmakers": {
"Bet365": [
{
"name": "ML",
"updatedAt": "2026-01-14T19:58:12Z",
"odds": [{ "home": "2.10", "draw": "3.40", "away": "3.60" }]
}
]
}
}
]過去データ用エンドポイント
過去データ用が4つ、ライン変動用が1つです。すべてのパラメータはAPIリファレンスに掲載しています。
- GET
/v3/ historical/ closing-lines - 多数のイベントの締切オッズを一括取得。最大10リーグ、366日、30ブックメーカー、指定したマーケットに対応します。有料プラン
- GET
/v3/ historical/ odds - 終了した1イベントの締切オッズと最終スコアを、最大30ブックメーカー分取得します。全プラン
- GET
/v3/ historical/ events - 1リーグの確定済みの試合と最終スコアを、最大31日分取得します。全プラン
- GET
/v3/ historical/ events/ search - 全リーグを対象に、チーム名で確定済みイベントを新しい順に検索します。全プラン
- GET
/v3/ odds/ movements - 1マーケットのプレマッチのライン変動。オープニングオッズ、最新オッズ、その間の変化を返します。全プラン
3ステップで1シーズン分をダウンロード
- 1
リーグと期間を選ぶ
競技を1つ、リーグのslugを最大10個、期間を最大366日で指定します。1シーズン全体を1回の取得範囲に収められます。
- 2
マーケットとブックメーカーを指定する
一括エンドポイントではmarketsとbookmakersが必須で、ブックメーカーは最大30社です。/v3/bookmakersにある名前ならどれでも使え、オッズは同じ名前で返ってきます。
- 3
シーズンをページ送りで取得する
1回のレスポンスには確定済みイベントが最大100件入ります。件数が100件に満たないページが返るまで、skipを指定して続けます。240試合のシーズンなら3リクエストで済みます。
開発者の活用例
ベッティングモデルのバックテスト
過去のシーズンでモデルを走らせ、その価格を各ブックメーカーの締切オッズと比較できます。最終スコアも同じレスポンスに含まれます。
クロージングラインバリュー（CLV）の測定
取ったオッズと締切オッズを比較します。変動履歴からオープニングオッズもわかるため、ラインがどれだけ動いたかを確認できます。
学習用データセットの構築
5リーグ1シーズン分の締切オッズを、1試合ずつ約1,900回呼び出す代わりに約20回のリクエストで取得できます。そのままデータフレームに読み込めるJSONで届きます。
データの範囲と上限
イベント一覧と一括の締切オッズは、確定済みイベントのみを返します。マーケット名は/v3/oddsと同じなので、過去データとライブデータを同じキーで結合できます。
- 締切オッズの履歴
- 2025年12月から
- 期間（一括の締切オッズ）
- 366日
- 期間（イベントと検索）
- 31日
- 一括リクエストあたりのリーグ数
- 10
- リクエストあたりのブックメーカー数
- 30
- 一括レスポンスあたりのイベント数
- 100件（skipでページ送り）
- フォーマット
- REST経由のJSON
過去オッズAPIのよくある質問
過去オッズデータはいつまで遡れますか？
締切オッズは2025年12月から提供しています。それ以前の試合と最終スコアも/v3/historical/eventsで取得できますが、オッズ用エンドポイントではそれらのイベントは空のbookmakersオブジェクトで返されます。
シーズン全体にはどのエンドポイントを使えばよいですか？
/v3/historical/closing-linesです。1リクエストで最大10リーグ・366日を指定でき、1ページあたり最大100件の確定済みイベントを返します。5リーグ1シーズン分を1イベントずつ取得すると約1,900リクエストかかりますが、一括エンドポイントなら約20回で同じデータが得られます。
過去オッズデータはプランに含まれますか？
/v3/historical/events、/v3/historical/events/search、/v3/historical/oddsは全プランで利用できます。/v3/historical/closing-linesには有料プランが必要です。新規の無料キーの発行は停止中のため、月額£49のSoloプランが最も手頃な始め方です。
対象となるマーケットとブックメーカーは？
締切オッズは、当社が対応するすべてのブックメーカーとマーケットについて、確定済みイベントごとに保存しています。マーケット名は競技によって異なり、多くはML、Totals、Spreadを使います。テニスはTotals (Games)とSpread (Games)、野球は最初の5イニングを省略せずに名前で示します。正確な名前は/v3/markets?sport=<sport>で、1イベントに含まれるすべてのデータはmarketsを指定せずに/v3/historical/oddsを呼び出すと確認できます。
ライン変動も取得できますか？それとも締切オッズだけですか？
/v3/odds/movementsは、1つのマーケットラインについてオープニングオッズ、最新オッズ、その間の変化を返します。履歴はプレマッチのみで、決まったブックメーカーについて記録しており、その一覧はドキュメントにすべて掲載しています。全プランで利用できます。
未確定や中止の試合も含まれますか？
/v3/historical/events、/v3/historical/events/search、/v3/historical/closing-linesは確定済みイベントのみを返すため、試合が終わっていても当社のシステムでまだ確定していなければ表示されません。/v3/historical/oddsはイベントのステータスを返すので、それを確認してください。中止を含むすべてのイベントについて明確な結果が必要な場合は、Bet Settlement APIを使ってください。