Python でスポーツのオッズデータを取得する方法

必要なもの

コードの検証状況: このチュートリアルの Python コードは、Odds-API.io のドキュメントに掲載された例のレスポンス（2026年11月3日確認）で実行して検証しました。実際の API キーでは実行していません。実際のレスポンスには項目が追加されている場合がありますが、コードはドキュメントに記載された項目だけを読みます。

1. パッケージを入れてキーを保存する

キーはコードに書かず、環境変数に保存します ^[1]。

python -m pip install requests websockets
export ODDS_API_KEY="your-api-key"   # Windows PowerShell: $env:ODDS_API_KEY="your-api-key"

2. 競技と今後の試合を一覧する

/sports はキー不要です。/events は競技を指定し、任意で league、status（例：pending、live）、期間、limit を指定できます ^[4]。

import os
import requests

BASE = "https://api.odds-api.io/v3"
API_KEY = os.environ["ODDS_API_KEY"]   # never hard-code or commit your key
BOOKMAKERS = "Bet365,Unibet"           # use bookmakers selected on your plan

def get(path, **params):
    """GET an Odds-API.io v3 endpoint and return parsed JSON."""
    params["apiKey"] = API_KEY
    r = requests.get(BASE + path, params=params, timeout=20)
    if r.status_code == 429:
        raise RuntimeError("Rate limit reached - wait before retrying")
    r.raise_for_status()
    return r.json()

sports = requests.get(BASE + "/sports", timeout=20).json()   # no key needed
print([s["slug"] for s in sports][:10])

events = get("/events", sport="football", league="england-premier-league",
             status="pending", limit=10)
for e in events:
    print(e["id"], e["date"], e["home"], "v", e["away"])

3. オッズを取得してインプライド確率を計算する

/odds は eventId 1 件、最大 30 社の bookmakers、任意の markets を受け取り、価格は小数の文字列で返ります ^{[4] [1]}。コードはインプライド確率に換算し、オーバーラウンドを比例法で除き、結果ごとの最良価格を求めます。計算はインプライド確率・控除除去計算ツールと同じです。

def ml_prices(event_odds):
    """{bookmaker: {"home": 2.1, "draw": 3.4, "away": 3.2}} from one /odds response."""
    out = {}
    for book, markets in event_odds.get("bookmakers", {}).items():
        for m in markets:
            if m["name"] == "ML" and m.get("odds"):
                row = m["odds"][0]
                out[book] = {k: float(row[k]) for k in ("home", "draw", "away") if k in row}
    return out

event_id = events[0]["id"]
prices = ml_prices(get("/odds", eventId=event_id, bookmakers=BOOKMAKERS, markets="ML"))

for book, p in prices.items():
    booksum = sum(1 / o for o in p.values())                 # implied probabilities
    fair = {side: (1 / o) / booksum for side, o in p.items()}  # proportional no-vig
    print(f"{book}: overround {booksum - 1:.2%}",
          {side: f"{q:.1%}" for side, q in fair.items()})

best = {}
for book, p in prices.items():
    for side, o in p.items():
        if o > best.get(side, (0, ""))[0]:
            best[side] = (o, book)
print("Best price per outcome:", best)

ドキュメントの例（Bet365 2.10／3.40／3.20）では、オーバーラウンドは 8.28% と表示されます。

4. 最大 10 試合を 1 リクエストで取得する

/odds/multi は最大 10 試合のオッズを返し、1 リクエストとして数えられます。1 時間 5,000 リクエストの枠では重要です ^{[4] [3]}。

ids = ",".join(str(e["id"]) for e in events[:10])   # up to 10 events
for ev in get("/odds/multi", eventIds=ids, bookmakers=BOOKMAKERS, markets="ML"):
    print(ev["home"], "v", ev["away"], ml_prices(ev))

5. WebSocket で価格の更新を受信する

試合中に動く価格は WebSocket 配信（wss://api.odds-api.io/v3/ws）で受け取ります。markets の指定は必須で、接続は permessage-deflate に対応している必要があります（Python の websockets は対応、websocket-client は拒否されます）。各 updated メッセージは市場の全体を含むため、保存済みのデータは統合せず置き換えます ^[5]。WebSocket は有料の追加オプションです ^[3]。

import asyncio, json, os
from urllib.parse import urlencode
import websockets   # needs permessage-deflate; "websocket-client" is refused

STATE = {}   # (event id, bookmaker) -> list of markets

async def stream():
    qs = urlencode({"apiKey": os.environ["ODDS_API_KEY"], "markets": "ML",
                    "sport": "football", "status": "live"})
    async with websockets.connect(f"wss://api.odds-api.io/v3/ws?{qs}",
                                  ping_interval=30, ping_timeout=10) as ws:
        async for raw in ws:
            msg = json.loads(raw)
            if msg["type"] in ("created", "updated"):
                STATE[(msg["id"], msg["bookie"])] = msg["markets"]   # replace, never merge
                for m in msg["markets"]:
                    if m["name"] == "ML" and m.get("odds"):
                        print(msg["id"], msg["bookie"], m["odds"][0])
            elif msg["type"] in ("deleted", "no_markets"):
                STATE.pop((msg["id"], msg["bookie"]), None)

asyncio.run(stream())

6. 次のステップ

価格差の分析は価格差（裁定）と期待値のデータ分析、Polymarket・Kalshi との比較は予測市場の価格とブックメーカーのオッズ比較を参照してください。

関連用語とツール

• オッズ API
• インプライド確率
• オーバーラウンド
• WebSocket 配信
• マネーライン
• オッズ変換ツール
• インプライド確率・控除除去計算ツール
• n8n・Make でオッズデータをノーコード収集
• MCP で Claude・ChatGPT からオッズデータを参照
• 価格差（裁定）と期待値のデータ分析
• 予測市場の価格とブックメーカーのオッズ比較
• Odds-API と SportsGameOdds の比較

よくある質問