Odds-API.io 活用事例：API キー取得から AI エージェントによるオッズ分析まで（賭けの段階と日本の法律）

ステップ1：Odds-API.io の API キーはどうやって取得する？

2026年11月2日時点で、Odds-API.io は新規の無料 API キーの発行を無期限で停止しています。停止前に発行された無料キーは引き続き使えます。無料キーが再開される場合は変更履歴（changelog）で告知するとしています ^[1]。現在のキー取得の流れは次のとおりです：

1. Odds-API.io の料金ページ 提携リンクでプランを選ぶ。入門プランは Solo（月額£49）です ^[2]。
2. カード、Apple Pay、Google Pay、PayPal で支払う。月額プランは10種類以上の暗号資産でも支払えます。年額プランはカードのみです ^[2]。
3. メールを確認する。ドキュメントによると、キーは登録したメールアドレスに届きます。MCP のページによると、支払い完了後はダッシュボードにも表示されます ^{[6] [3]}。
4. ダッシュボードでブックメーカーを選ぶ。選べる数はプランで決まり、同じキーのまま後から変更できます ^[2]。
5. キーを秘密にする。ドキュメントは、バージョン管理にコミットせず、ODDS_API_KEY などの環境変数に保存するよう注意しています ^[6]。

支払い前に試せるエンドポイントもあります。GET https://api.odds-api.io/v3/sports はキー不要です ^[6]：

curl "https://api.odds-api.io/v3/sports"
# → [{"name": "Football", "slug": "football"}, {"name": "Basketball", "slug": "basketball"}, ...]

紹介割引：Odds-API.io の提携プログラムのページによると、提携リンク経由の顧客は最初の3か月が30%割引になります。料金 FAQ では、プロモコードとアフィリエイト割引は月額プランのみ対象とされています。支払い前に決済画面で最終金額を確認してください ^{[7] [2]}。

プランを選んでキーを取得 → 提携リンク

ステップ2：Odds-API.io の無料プランと有料プランの違いは？料金比較

有料プラン同士の違いは、選べるブックメーカーの数だけです。リクエスト数、競技、マーケットはどの有料プランでも同じです。無料枠は別物で、リクエスト上限がずっと低く、レクリエーション向けのブックメーカーに限られ、新規登録は受け付けていません ^{[2] [1]}。

プランを選ぶ

提携リンク（広告）— 当サイトが報酬を得る場合があります。アフィリエイト表記を参照。

2026年11月2日時点の掲載価格 ^{[2] [1]}。

• 年払いは月額の10倍なので2か月分無料。年額プランはカードのみで、追加リクエストパッケージとは併用できません ^[2]。
• WebSocket 配信はプラン料金と同額の追加オプション（合計2倍）。例：Solo＋WebSocket は月額£98。Odds-API.io は最も低遅延な方法として推奨しています ^[2]。
• リクエスト追加：毎時10,000（月額＋£139）、20,000（＋£229）、30,000（＋£309）に引き上げられます ^[2]。
• 通貨：価格は英ポンド表示ですが、決済は現地通貨（GBP、USD、EUR、BRL、CNY、JPY、KRW）で請求されます。日本円でも支払えます ^[2]。
• 有料限定機能：ネイティブ ID マッピング（Polymarket/Kalshi の ID）と急落オッズは、ドキュメント上で有料プランの機能とされています ^{[8] [9]}。

この事例に合うプランは？ブックメーカー1社を Polymarket・Kalshi と比べるには3社分が必要なので Starter（5社）です。ブックメーカー2社と予測市場2つを比べる場合も4社なので Starter。Solo は2つのデータ源の比較にしか使えません。

Odds-API.io のプランを比較 → 提携リンク

ステップ3：AI エージェントに Odds-API.io のデータを取得させるには？（MCP・REST）

方法は2つあります。エージェントにドキュメントを渡して REST のコードを書かせるか、公式 MCP サーバーでライブのツールを渡すかです。Odds-API.io によると、多くの人は両方を使っています ^{[3] [9]}。

方法A：公式 MCP サーバー（Claude、Codex、Cursor、VS Code）

サーバーは npm パッケージ odds-api-mcp-server で、MIT ライセンスのオープンソースです。手元のマシンで stdio 経由で動き、キーは api.odds-api.io にのみ送られます。ツール呼び出しは通常の API リクエストとして毎時5,000の枠にカウントされます ^[3]。

# Claude Code
claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

# Codex CLI
codex mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

Claude Desktop（claude_desktop_config.json）や Cursor（.cursor/mcp.json）では、次のブロックを追加します ^[9]：

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": { "ODDS_API_KEY": "your-api-key" }
    }
  }
}

VS Code は .vscode/mcp.json を使い、"mcpServers" の代わりにトップレベルの "servers" キーを使います。Docker イメージ（oddsapi/odds-api-mcp-server）と、Claude Desktop 用のワンクリック .mcpb ファイルもあります ^[3]。

25のツールには get_events、search_events、get_odds、get_multi_odds、get_odds_movements、get_value_bets、get_arbitrage_bets、get_historical_odds、grade_bets などがあります。サーバーはデータを読むだけで、ブックメーカーへのログインや賭けはできません ^[3]。

ChatGPT の場合は？

ChatGPT は SSE またはストリーミング HTTP でリモートの MCP サーバーに接続するため、odds-api-mcp-server のようなローカルの stdio サーバーを直接起動できません。OpenAI はプライベート／ローカルのサーバー向けに Secure MCP Tunnel を提供しています ^[10]。ChatGPT でより簡単なのはドキュメント方式で、Odds-API.io は https://docs.odds-api.io/llms-full.txt を読ませるか、コピー用のコンテキストを貼り付けることを勧めています ^[9]。OpenAI 製品で MCP ツールを使いたい場合は、上の Codex CLI のコマンドが公式に対応した方法です。

方法B：エージェントに REST のコードを書かせる（Python / TypeScript）

ベース URL は https://api.odds-api.io/v3 で、キーはクエリパラメータ apiKey で渡します ^[9]。公式 SDK は pip install odds-api-io と npm install odds-api-io です ^[11]。

# Python — official SDK (pip install odds-api-io)
import os
from odds_api import OddsAPIClient

client = OddsAPIClient(api_key=os.environ["ODDS_API_KEY"])
events = client.get_events(sport="football", league="england-premier-league")
odds = client.get_event_odds(event_id=events[0]["id"],
                             bookmakers="Bet365,Polymarket,Kalshi")
for bookie, markets in odds["bookmakers"].items():
    ml = next((m for m in markets if m["name"] == "ML"), None)
    if ml:
        o = ml["odds"][0]
        print(bookie, o["home"], o.get("draw"), o["away"])
print(odds.get("urls", {}))   # direct links to the event at each bookmaker

// TypeScript — official SDK (npm install odds-api-io)
import { OddsAPIClient } from "odds-api-io";

const client = new OddsAPIClient({ apiKey: process.env.ODDS_API_KEY! });
const events = await client.getEvents({ sport: "football", league: "england-premier-league" });
const odds = await client.getEventOdds({ eventId: events[0].id, bookmakers: "Bet365,Polymarket,Kalshi" });
for (const [bookie, markets] of Object.entries(odds.bookmakers)) {
  const ml = markets.find((m) => m.name === "ML");
  if (ml?.odds?.[0]) console.log(bookie, ml.odds[0].home, ml.odds[0].draw, ml.odds[0].away);
}

Odds-API.io の MCP ページにあるエージェントへの質問例：「今週末のプレミアリーグで、Bet365 と Unibet の勝敗オッズの差が最も大きい試合は？」エージェントは get_events と get_multi_odds を使って答えます ^[3]。

MCP サーバー用のキーを取得 → 提携リンク

ステップ4：事例 — 1試合をブックメーカーと予測市場で分析するには？

説明用のサンプルデータです。以下の Polymarket と Kalshi の価格は、Odds-API.io の予測市場ガイドにあるサンプル値（リーズ・ユナイテッド対アーセナル、ML マーケット）です ^[12]。ブックメーカー2行は説明のために作った架空の値です。いずれも実際の価格ではなく、結果・予想・利益を示すものでもありません。

4.1 データの形

GET /v3/odds?eventId=…&bookmakers=Polymarket,Kalshi,Bet365,Unibet は試合ごとに1つのオブジェクトを返します。マーケットをまとめた bookmakers、各ブックメーカーの試合ページへのリンクを持つ urls、予測市場については bookmakerIds とバック／レイ価格、米ドル建ての板の厚みが含まれます ^{[12] [6]}：

"Polymarket": [{ "name": "ML", "odds": [{ "home": "6.67", "draw": "4.35", "away": "1.56",
  "layHome": "1.61", "layAway": "7.14", "layDraw": "4.55",
  "depthHome": "12128", "depthAway": "331", "depthDraw": "26086" }] }]

4.2 示唆確率とオーバーラウンド

示唆確率は 1 ÷ 小数オッズです。セント表示の予測市場の価格も同じように換算でき、60¢ は60%、オッズ1.67です ^[12]。3つの結果を合計すると、各データ源のマージン（オーバーラウンド）がわかります：

4.3 マージンを取り除く（公正確率）

最も簡単なマージン除去は、各示唆確率を合計で割る方法です。ブックメーカーAの 16.7 / 23.8 / 65.4（合計105.8）は約 15.7% / 22.5% / 61.8% になり、公正オッズは約 6.35 / 4.45 / 1.62 です。比例配分は方法の一つにすぎません。Odds-API.io のバリューベット・エンジンは、ソフト系ブックの上乗せマージンが基準を歪めるため、シャープ系ブックメーカーの集合から公正オッズを作っています ^[13]。

4.4 ラインショッピング（最良オッズの比較）

4つのデータ源で結果ごとの最良価格は、ホーム6.67（Polymarket）、引分4.35とアウェイ1.56（Polymarket と Kalshi）です。最良価格の合計は102.1%で100%を超えるため、この説明用の試合にアービトラージはありません。Odds-API.io の定義では、最良価格の合計が100%未満である必要があります ^[14]。

4.5 ブックメーカーと予測市場：「バリュー」はある？

架空のブックメーカー2社のマージン除去後の確率の平均を仮の公正ライン（ホーム≈15.5%）とすると、Polymarket のホーム6.67は EV = 0.155 × 6.67 − 1 ≈ +3% になります。これはドキュメントの式 EV = 公正確率 × オッズ − 1 です ^[13]。実際にはこの数字は次の理由で縮むか消えます：

• 基準が架空のソフト系2社の価格で、シャープ系のコンセンサスではない ^[13]；
• Polymarket と Kalshi には手数料があり、Odds-API.io のアービトラージ・エンジンは netOdds でこれを扱う ^{[14] [15] [16]}；
• 板の厚みが重要：流動性の薄い価格では意味のある金額を取れないとドキュメントは注意している ^[12]；
• スナップショットから注文までに価格は動く。ドキュメントはバリューベットを理論上のものとし、すべてが勝つわけではないとしている ^[13]。

# Python: de-vig, line shopping and EV on an /v3/odds response (illustrative)
def implied(o): return 1 / float(o)

def devig(prices):                       # prices = {"home": "6.00", "draw": "4.20", "away": "1.53"}
    p = {k: implied(v) for k, v in prices.items() if k in ("home", "draw", "away")}
    total = sum(p.values())
    return {k: v / total for k, v in p.items()}, total - 1   # fair probs, overround

def best_prices(event):
    best = {}
    for book, markets in event["bookmakers"].items():
        ml = next((m for m in markets if m["name"] == "ML"), None)
        if not ml: continue
        for side in ("home", "draw", "away"):
            price = float(ml["odds"][0][side])
            if side not in best or price > best[side][0]:
                best[side] = (price, book, event.get("urls", {}).get(book))
    return best

def ev(fair_prob, odds): return fair_prob * float(odds) - 1   # docs formula

4.6 API に任せる：/value-bets と /arbitrage-bets

Odds-API.io はこれらの計算も行います。/v3/value-bets?bookmaker=… は expectedValue、betSide、bookmakerOdds.href を返し、5秒ごとに再計算されます ^[13]。/v3/arbitrage-bets?bookmakers=… は profitMargin、legs[]（判明している場合は netOdds と maxStake 付き）、optimalStakes[] を返します。対象は試合前のみで、マージンは「提示価格での計算であり、保証されたリターンではない」とされています ^[14]。

ドキュメントの注意点：REST ガイドの例では expectedValue は小数（0.0523 = 5.23%）ですが、SDK の一例ではパーセント形式の値として100を引いています。しきい値を決める前に実際のレスポンスで確認してください ^{[13] [11]}。

自分の Odds-API.io キーでこの分析を試す → 提携リンク

ステップ5：分析の後、賭けの段階で何が起きる？日本の法律との関係

Odds-API.io はデータサービスです。API も MCP サーバーも賭けはできません ^[3]。API のレスポンスには各ブックメーカーの試合ページへのリンク（urls、bookmakerOdds.href、legs[].href）が含まれますが ^{[6] [13] [14]}、その先で賭けられるかどうかは、プラットフォームと居住地の法律で決まります。

日本在住の場合

• 刑法185条は賭博を50万円以下の罰金または科料、186条は常習賭博を3年以下の拘禁刑と定めています ^[4]。
• 警察庁は、海外で合法的に運営されているサイトでも、日本国内から接続して賭博を行うことは犯罪であり、スポーツベッティングも含まれるとしています ^[5]。
• 2025年9月25日からは、違法オンラインギャンブル等のサイトを国内の不特定の者に提示したり、誘導する情報を発信したりすることも禁止されています ^[17]。このため本ページの日本語版では、賭けの手順やブックメーカー・予測市場の取引サイトへのリンクを掲載していません。
• Polymarket は日本でサイトの利用を制限しています ^[18]。日本で予測市場を個別に認める制度は当サイトでは確認できず、金銭を賭ければ賭博罪に当たるおそれがあります（当サイトの見解であり法的助言ではありません）。

日本でできること：オッズや予測市場の価格を集めて、確率推定、マージン分析、AI 予測の検証（ブライアスコアでの採点など）、研究や記事・ダッシュボードの作成に使うことです。Odds-API.io の規約上、自社製品でのデータ表示は認められていますが、生データの再販にはエンタープライズ契約が必要です ^[19]。

海外のプラットフォームの一般的なルール（参考）

• ブックメーカー（例：bet365）：2026年9月28日発効の一般規約は、アービトラージ（§16.2(e)）、VPN による所在地の偽装（§16.2(k)）、スクレイピング（§16.2(w)）、「人工知能、自動プレイヤー（ボット）、プレイヤー支援ソフトウェア」の使用（§16.2(z)）を「禁止行為」とし、自動システムによる賭けを無効にできるとしています（§14.5(c)）^[20]。Odds-API.io も、バリューを見つけ続けるアカウントはブックメーカーに制限される場合があると注意しています ^[13]。
• Polymarket：ブロック対象地域からの注文は拒否され、VPN での回避は規約違反です。米国・英国・フランス・ドイツ・イタリア・台湾・シンガポール・オーストラリアなどは決済のみ可能です ^{[18] [21]}。
• Kalshi：18歳以上で本人確認書類を求められる場合があり ^[22]、2026年6月22日の取引所通知は英国、カナダ、オーストラリア、フランス、イタリア、アイルランド、ポーランド、ポルトガル、スイス、台湾、シンガポール、タイ、中国などからの取引を禁止しています ^[23]。米国ではスポーツ契約が州・連邦の裁判で争われています ^[24]。

イベント契約にもインサイダー取引規制が適用され、CFTC は摘発事例を公表しています ^{[31] [32]}。

よくある質問