オッズデータAPI
10社のブックメーカー・7競技・69リーグのプレマッチオッズを、機械が読めるJSONで提供します。登録不要の無料キーですぐに始められます。
- 10
- ブックメーカー
- 7
- 競技
- 69
- リーグ
- 296
- 7日以内の試合
- 3194
- 最終オッズ記録のある試合
サイトの画面と何が違うのか
サイトの画面はこれまでどおり無料で、追加の遅延はありません。APIは画面にないものを提供します。
- 機械向けJSON試合・リーグ・チーム・ブックメーカーを一つのID体系で、10社が同じ形式
- 一度にすべて試合ごとに全ブックメーカー・全マーケット・全ライン(画面は選んだ表だけ)
- 行ごとの鮮度changed_at・seen_at・age_sec・suspended で古い値を機械が判断
- 差分だけsince カーソルで前回以降に変わった試合だけ
- 最終オッズの記録 準備中終了した試合のブックメーカー別最終値と結果
- 独自オッズ 準備中結果から作ったモデルの確率・公正オッズ、成績表を公開
- 組み合わせ・ミドル・乖離の全リスト 準備中各レッグの経過秒と実確認状態
料金 準備中
有料利用は準備中です。現在は無料プランのみで、以下は予定料金です。
試合を初めて取得したときに一度だけ 0.03 USDT。その後は試合開始まで追加料金なしで呼び出せます(リクエスト上限は毎分120回)。1か月の合計は 49 USDT を超えません。フィルターで行が残らない試合とオッズのない試合は課金しません。
| 商品 | 料金 | 条件 |
|---|---|---|
| オッズ(最新・追加遅延なし) | 0.03 USDT / 試合 | 全ブックメーカー・全マーケット・全ライン、開始後の最終オッズと結果を含む・月上限 49 USDT · 実測遅延の表 → |
| 独自オッズ | +0.01 USDT / 試合 | サッカー勝敗確率・公正オッズ・月上限 9 USDT |
| 組み合わせ・ミドル・乖離 | 5 USDT / 30日 | 全リスト・フィルター・30日利用券、自動更新を選択可 |
| 最終オッズ記録 | 0.01 USDT / 試合 | 終了試合のブックメーカー別最終値(メインライン)・月上限の対象外(月の支出上限には含む) |
| 無料 | 0 | 5〜10分遅れのスナップショット・メインラインのみ・1日20試合・1時間100回 |
| 取得範囲 | 月の試合数 | 費用 |
|---|---|---|
| 特定の試合 5件 | 5 | 0.15 USDT |
| Friendly International のみ | 約 91 | 約 2.73 USDT |
| サッカー 全体 | 約 699 | 約 20.97 USDT |
| すべて | 約 2240 | 上限 49 USDT |
支払い:USDT前払い(BSC・TRON)、最低チャージ 10 USDT。登録不要でキーにチャージします。
料金・月上限の引き上げや無料・リクエスト上限の引き下げは、告知から7日が過ぎた後に最初に来る月の1日から適用します。利用者に有利な変更は即時に適用します。
無料キーを取得
このキーは今回だけ表示されます。コピーして安全な場所に保管してください。 なくした場合は新しい無料キーを取得してください(同じIPから1日3個)。
クイックスタート
3ステップ:① キーを取得 ② 範囲を選ぶ(/meta/leagues)③ /quote で費用を確認してから /odds。
export ODDSBUNCH_KEY=obd_... # the key from POST /keys
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/meta/leagues?sport=soccer"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/quote?league=386"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/odds?league=386&limit=5&main_only=true&markets=1x2"import os, requests
H = {"Authorization": f"Bearer {os.environ['ODDSBUNCH_KEY']}"}
r = requests.get("https://oddsbunch.com/api/data/v1/odds", params={"league": 386, "limit": 5}, headers=H, timeout=30).json()
print(r["billing"], len(r["data"]))const H = { Authorization: `Bearer ${process.env.ODDSBUNCH_KEY}` };
const r = await (await fetch("https://oddsbunch.com/api/data/v1/odds?league=386&limit=5", { headers: H })).json();
console.log(r.billing, r.data.length);
例ではキーを環境変数 ODDSBUNCH_KEY から読みます。キーをコードに直接書かないでください。
独自オッズ(oddsbunch-model-v1) 準備中
サッカー勝敗の確率と公正オッズ(1÷確率)。過去の試合結果と選手記録から作った推定値で、ブックメーカーのオッズを写したものではありません。
応答ごとに根拠(basis: lineup・time)、試合前データが完全か(pre_complete)、計算時刻(computed_at)、ラインナップ変更による再計算の履歴が付きます。完全かどうかの最終判定(complete)は試合後に出ます。
実戦成績(2026-10-20〜2026-11-18、同じ時点のブックメーカー合意と同じ試合で比較)
| 完全データ 348試合 | 有意な差なし | Brier差 +0.0045 ± 0.0059 |
| 不完全データ 244試合 | ブックメーカーより悪い | Brier差 +0.0469 ± 0.0126 |
| ラインナップ確定前の値(time)101試合 | ブックメーカーより悪い | Brier差 +0.0603 ± 0.0215 |
完全かどうかは試合後に判定します・試合前は pre_complete で示します。 不完全データの試合の値は参考用です。成績表は毎日更新され、無料です。
仮想ピックの収益率(仮想 — 実際のベットではありません):+3.7%・322ピック
AIエージェント
人の手をほとんど介さずに組み込めるように作りました。
- OpenAPI 3.1 仕様 —
https://oddsbunch.com/api/data/v1/openapi.json - Markdown全文(docs.md) —
https://oddsbunch.com/api/data/v1/docs.md - llms.txt
- /quote は課金せずに費用を計算します。エージェントが先に人へ確認できます。max_charge・buy=false・月の支出上限で、使う金額をサーバー側で制限できます。
- エラーごとに次の対応(fix)とドキュメントURL(docs)が付きます。
- MCPサーバーは準備中です。
会員の分析記事をAIエージェントで投稿するAPIは別にあります。 お知らせ「API・AIエージェント」→
よくある質問
サイトの画面をプログラムで読み取ってもいいですか?
画面は人が見るためのもので、自動収集は利用規約で禁止しています。機械で読むならこのAPIを使ってください。無料キーは遅延したメインラインから始まります。
同じ試合を何度も呼ぶと何度も課金されますか?
(準備中) いいえ。試合ごとに最初の一回だけ課金され、同じアカウントのすべてのキーが試合開始まで(開始後の最終オッズ・結果を含む)共有します。
月上限に達するとどうなりますか?
(準備中) その月(UTCの暦月)の残りの試合はオッズ課金されません。すべて取得しても1か月 49 USDT を超えません。上限は試合開始の月で数えるため、翌月の試合は翌月の上限に入ります。
残高が足りないときは?
(準備中) すでに取得した試合はそのまま返し、新しい試合は除いて、取得できなかった数(unpaid_matches)とチャージ方法をお知らせします。黙って遅延データに切り替えることはしません。
チャージしたお金は返金されますか?
(準備中) キーだけで作ったアカウントの残高は出金できず、API利用にのみ使えます(データAPI終了時の返却は例外)。サイト会員のキーはサイトの出金ルールに従います。収集が止まっている間に試合を購入した、またはその試合が始まり、停止中にその試合のオッズが更新されなかった場合(止まったデータを購入した場合)は、試合開始後にオッズの課金を自動で返金します(独自オッズ・最終オッズ記録は対象外)。返金した試合は無効になり、その金額は月上限の計算からも外れます。中止になった試合も自動で返金します。
データはどれくらい遅れますか?
ブックメーカーの更新から反映まで通常1分前後、遅いと数分です(ドキュメントに競技別の実測表)。行ごとに age_sec があるので基準を決めて除外してください。無料キーは5〜10分遅れのスナップショットです。
取得したデータを再販売・公開してもいいですか?
データそのものの再販売・提供は利用規約7-2で禁止しています。自分の分析・結果の画面に一部の値を示すことは問題なく、その際は出典を Oddsbunch と表記してください。禁止された利用が見られた場合、そのアカウントのAPI利用を停止することがあります。