オッズデータAPI リファレンス
エンドポイント・課金・鮮度・エラーを1ページに。機械向けドキュメントも同じ内容です。
機械向け: openapi.json · docs.md · llms.txt
はじめに
3ステップです。
- キーを取得 —
POST https://oddsbunch.com/api/data/v1/keysに{"accept_notice": true}。登録は不要です。キー(obd_…)は一度だけ表示されます。 - 範囲を選ぶ —
GET /meta/sports、/meta/leagues?sport=soccer、/matches?league=…が当サイトのIDを返します。 - 費用を確認してから取得 —
GET /quote?league=…は課金せずに新規試合の数を教えてくれます。その後GET /odds?league=…、以降はsince=<meta.cursor>を付けて変わった試合だけを受け取ってください。
有料利用はまだ始まっていません。現在、すべてのキーは無料キーです。
費用のルール: 新規試合数 × 0.03 USDT、UTCの暦月ごとに 49 USDT を超えません。取得済みの試合は試合開始まで再課金しません。
無料キーは 5~10分遅れのスナップショット・メインラインのみ・1日 20試合・1時間 100回で、範囲(ids・sport・league・team)を1つ選ぶ必要があります。試すときは limit=5&main_only=true&markets=1x2 が軽量です。ベースURL:https://oddsbunch.com/api/data/v1。
ページとデルタ: meta.next_page が null になるまで全ページを取得してください。どのページの meta.cursor も同じで、全ページを取得してからそのカーソルで次の since を呼びます。410 cursor_expired なら since なしで最初から(全ページ)取り直してください。
BASE="https://oddsbunch.com/api/data/v1"
# 1) Free key, no sign-up (read GET $BASE/notice first). The key is shown once — save it.
curl -s -X POST "$BASE/keys" -H "Content-Type: application/json" -d '{"accept_notice": true}'
export ODDSBUNCH_KEY=obd_... # data.key from the response
AUTH="Authorization: Bearer $ODDSBUNCH_KEY"
# 2) Scope: leagues of a sport (our IDs)
curl -s --compressed -H "$AUTH" "$BASE/meta/leagues?sport=soccer"
# 3) Cost preview (no charge), then fetch — follow meta.next_page until null (all pages share one cursor)
curl -s --compressed -H "$AUTH" "$BASE/quote?league=386"
curl -s --compressed -H "$AUTH" "$BASE/odds?league=386" -o page1.json
CURSOR=$(jq -r '.meta.cursor' page1.json); NEXT=$(jq -r '.meta.next_page // empty' page1.json)
while [ -n "$NEXT" ]; do
curl -s --compressed -H "$AUTH" "$BASE/odds?league=386&page_token=$NEXT" -o next.json
NEXT=$(jq -r '.meta.next_page // empty' next.json)
done
# 4) Deltas: only matches changed since the cursor (after taking all pages)
curl -s --compressed -H "$AUTH" "$BASE/odds?league=386&since=$CURSOR"
# Errors: -i shows the status; on 429 read Retry-After, on 410 fetch again without since
curl -si --compressed -H "$AUTH" "$BASE/odds?league=386" | head -20import os, time, requests
BASE = "https://oddsbunch.com/api/data/v1"
def get_key():
# Free key, no sign-up. Store it safely; it cannot be shown again.
r = requests.post(f"{BASE}/keys", json={"accept_notice": True}, timeout=30)
r.raise_for_status()
return r.json()["data"]["key"]
KEY = os.environ.get("ODDSBUNCH_KEY") or get_key()
S = requests.Session()
S.headers["Authorization"] = f"Bearer {KEY}" # requests sends Accept-Encoding: gzip by default
class CursorExpired(Exception):
pass
def call(path, **params):
while True:
r = S.get(f"{BASE}{path}", params=params, timeout=30)
if r.status_code == 429: # rate limited
time.sleep(int(r.headers.get("Retry-After", "60")))
continue
body = r.json()
if r.status_code == 410: # cursor_expired: start over without since
raise CursorExpired()
if r.status_code == 401: # key_missing / key_invalid / key_revoked
raise SystemExit(f"Key problem: {body['error']} -> {body['fix']}")
if r.status_code == 402: # payment_required / over_budget
raise SystemExit(f"{body['error']}: {body['message']} -> {body['fix']}")
if not body.get("ok"):
raise RuntimeError(f"{body['error']}: {body['message']} ({body['docs']})")
return body
def fetch_all(**params):
"""All pages of one request. Every page has the same meta.cursor."""
items, removed, cursor, token = [], [], None, None
while True:
page = call("/odds", **params, **({"page_token": token} if token else {}))
cursor = page["meta"]["cursor"]
items += page["data"]
removed += page.get("data_removed", [])
token = page["meta"]["next_page"]
if not token:
return items, removed, cursor, page["meta"]["tier"]
leagues = call("/meta/leagues", sport="soccer")["data"]
league_id = leagues[0]["id"]
quote = call("/quote", league=league_id)["data"]
print("new matches:", quote["new_matches"], "cost:", quote["cost"], "USDT")
# An agent should ask its human before a large charge (or pass max_charge=…).
seen = set() # de-duplicate lines across deltas
items, _, cursor, tier = fetch_all(league=league_id)
for item in items:
m = item["match"]
print(m["id"], m["home"]["name"], "vs", m["away"]["name"])
while True:
time.sleep(60 if tier == "paid" else 300) # free snapshots are rebuilt every 5 min
try:
items, removed, cursor, tier = fetch_all(league=league_id, since=cursor)
except CursorExpired:
items, removed, cursor, tier = fetch_all(league=league_id) # start over (all pages)
for item in items:
for mk in item["markets"]:
for ln in mk["lines"]:
for b in ln["books"]:
k = (item["match"]["id"], b["bookmaker"], mk["market"], ln["line"], b["changed_at"])
if k not in seen:
seen.add(k)
print("changed:", k)
for r in removed:
print("removed:", r["id"], r["reason"])const BASE = "https://oddsbunch.com/api/data/v1";
async function getKey() {
// Free key, no sign-up (call from a server or a terminal). Store it safely; it cannot be shown again.
const r = await fetch(`${BASE}/keys`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ accept_notice: true }),
});
if (!r.ok) throw new Error(`key: HTTP ${r.status}`);
return (await r.json()).data.key;
}
const KEY = process.env.ODDSBUNCH_KEY || (await getKey());
const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
class CursorExpired extends Error {}
async function call(path, params = {}) {
const url = `${BASE}${path}?${new URLSearchParams(params)}`;
for (;;) {
const r = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } }); // fetch handles gzip
if (r.status === 429) { await sleep(1000 * Number(r.headers.get("Retry-After") || 60)); continue; }
const body = await r.json();
if (r.status === 410) throw new CursorExpired();
if (r.status === 401) throw new Error(`Key problem: ${body.error} -> ${body.fix}`);
if (r.status === 402) throw new Error(`${body.error}: ${body.message} -> ${body.fix}`);
if (!body.ok) throw new Error(`${body.error}: ${body.message} (${body.docs})`);
return body;
}
}
async function fetchAll(params) {
// All pages of one request share meta.cursor; use it only after the last page.
let items = [], removed = [], token = null, page;
do {
page = await call("/odds", token ? { ...params, page_token: token } : params);
items = items.concat(page.data);
removed = removed.concat(page.data_removed || []);
token = page.meta.next_page;
} while (token);
return { items, removed, cursor: page.meta.cursor, tier: page.meta.tier };
}
const leagues = (await call("/meta/leagues", { sport: "soccer" })).data;
const league = leagues[0].id;
const quote = (await call("/quote", { league })).data;
console.log("new matches:", quote.new_matches, "cost:", quote.cost, "USDT");
let res = await fetchAll({ league });
console.log(res.items.length, "matches");
for (;;) {
await sleep(res.tier === "paid" ? 60_000 : 300 * 1000);
try {
res = await fetchAll({ league, since: res.cursor });
} catch (e) {
if (!(e instanceof CursorExpired)) throw e;
res = await fetchAll({ league }); // start over (all pages)
}
for (const item of res.items) console.log("changed:", item.match.id);
for (const r of res.removed) console.log("removed:", r.id, r.reason);
}
認証
キーは次のどちらかのヘッダーで送ります:Authorization: Bearer obd_… または X-API-Key: obd_…。URL(クエリ)には入れないでください。当サイトはキーのハッシュだけを保存するため、失くしたキーは再表示できません。メールを連携していれば POST /account/recover でアカウントを取り戻し、そうでなければ新しい無料キーを取得してください(新しいキー=新しいアカウントなので、取得済みの試合・残高は移りません)。使っているキーを替えるには POST /keys/rotate(呼び出したキーは "keep_old": true でなければすぐ廃止)、キー1つの廃止は DELETE /keys/{hint}。廃止されたキーは 401 key_revoked と reason を返します。新しいキーを作らず、同じアカウントの別のキーを使ってください。同じアカウントのキーは購入済みのものをすべて共有します。読み取り系エンドポイントは Access-Control-Allow-Origin: * なのでブラウザのコードからも呼べますが、キーの発行・復旧は CORS を開いていません(サーバー・ターミナルから)。有料キーを公開ウェブページに入れないでください。
課金と月上限
有料利用はまだ始まっていません。現在、すべてのキーは無料キーです。
- オッズ: アカウントがある試合を初めて受け取るとき、0.03 USDT を1回だけ課金します。その後はアカウントのすべてのキーが、その試合(全ブックメーカー・全マーケット・全ライン)を試合開始までリクエスト上限の範囲で何度でも取得でき、開始後の最終オッズと結果も含まれます。
- 月の上限: UTCの暦月に開始する試合のオッズ課金が 49 USDT に達すると、その月の試合にはそれ以上課金しません。上限は試合が開始する月が基準なので、翌月の試合は翌月の上限に入ります。上限をまたぐリクエストは残りの分だけ課金します。
- フィルター:
bookmakers・markets・main_onlyは応答を絞るだけで価格は変わりません。フィルターで行が1つも残らない試合とオッズのない試合は課金しません(skipped: filtered_out・no_odds)。 - 自分で決める上限: リクエストごとの
max_charge=<USDT>、取得済みの試合だけを受け取るbuy=false、全商品合計の月の支出上限(POST /account/budget)。超えるリクエストは402 over_budgetで拒否され、課金はありません。 - 追加商品: 独自オッズ 1試合 +0.01 USDT(上限 9)、組み合わせ・ミドル・乖離の30日利用券 5 USDT、最終オッズ記録 終了した試合ごとに 0.01 USDT(上限の対象外)。
- 残高が足りないとき: 取得済みの試合はそのまま返し、新しい試合は除いて
billing.unpaid_matchesで知らせます(HTTP 200)。要求した試合がすべて新規で支払えなければ402 payment_required。有料アカウントを黙って遅延データに切り替えることはありません。 - すべての応答に
billing:charged・new_matches・balance・month_spent・month_cap・free_left_today。 - USDT 前払い:
POST /account/topupでチャージ(BSC・TRON、最低 10 USDT)。キーだけで作ったアカウントの残高は出金できません。収集が止まっている間に試合を購入した、またはその試合が始まり、停止中にその試合のオッズが更新されなかった場合(止まったデータを買った場合)、オッズの課金を試合開始後に自動で返金します(独自オッズ・最終オッズ記録は除く)。返金した試合は無効となり、再取得すると再度課金され、その金額は上限の計算からも外れます。中止された試合も返金し、延期された試合は同じIDのまま、取得済みの扱いも続きます。 - 価格・上限の引き上げや無料・リクエスト上限の引き下げは、告知日から7日が過ぎた後に最初に来る月の1日から適用し、有利な変更はすぐに適用します。
鮮度フィールド
オッズの各行には4つのフィールドが付き、古い値をコードで判断できます。
| フィールド | 意味 |
|---|---|
| changed_at | この値が最後に変わった時刻(UTC) |
| seen_at | 当サイトの収集で最後に確認した時刻 |
| age_sec | changed_at から meta.generated_at までの経過秒(応答を作るときに計算) |
| suspended | ブックメーカーがそのラインを取り下げていれば true、最後の値は残します |
サッカーとアメフトは差分で受信するため、値が変わらない行の seen_at は最大10分遅れて更新されます。古さは changed_at・age_sec で判断してください。book_marked_main はブックメーカーがメインと表示したライン、行グループの main は当サイトが選んだ代表ラインです。パーセントのフィールドは _pct で終わり(combined_payout_pct)、roi は比率です。無料キーは 5分ごとに作り直し、5分以上経ったものだけを返すスナップショットなので、meta.delay_sec は 300 からその2倍強の間です。組み合わせは各レッグの経過秒と最も古いレッグの経過秒を、105%以上の組み合わせは verify 状態(same 実際の値と一致・diff・unverifiable・pending)も返します。
実測遅延
ブックメーカーが値を変えた時刻から当サイトの changed_at までの時間(最近のデータでの実測)。通常は1分前後、遅いときは数分です。
| 競技 | 中央値 | 90% |
|---|---|---|
| サッカー | 42秒 | 75秒 |
| アイスホッケー | 39秒 | 174秒 |
| eスポーツ | 43秒 | 67秒 |
| バスケットボール | 58秒 | — |
| アメリカンフットボール | 64秒 | 168秒 |
測定 2026-11-18・直近2時間の標本・ブックメーカー更新時刻 → 当サイト反映時刻
エラー
エラーは常に同じ形なので、エージェントは人の手を借りずに次の行動を取れます。
{
"ok": false,
"error": "payment_required",
"message": "Balance 0.01 USDT is below the 0.03 USDT needed for 1 new match.",
"fix": "Top up with POST /account/topup, or narrow the scope (ids=…).",
"docs": "https://oddsbunch.com/api/data/v1/docs.md#errors",
"docs_html": "https://oddsbunch.com/en/api/docs#errors",
"request_id": "r_…"
}
| HTTP | error | すること |
|---|---|---|
| 400 | bad_scope | 応答に使えるパラメーターの一覧があります。クエリを直してください。 |
| 400 | bad_param | パラメーターの値が誤っています。どれかは invalid に出ます。 |
| 400 | notice_required | "accept_notice": true を送ってください(先に GET /notice)。 |
| 400 | scope_required_free | 無料キーは範囲(ids・sport・league・team)を1つ選ぶ必要があります。 |
| 400 | bad_json | 正しい JSON を送ってください。 |
| 401 | key_missing · key_invalid | POST /keys でキーを取得するか、ヘッダーを確認してください。 |
| 401 | key_revoked | 廃止されたキーです(reason)。新しいアカウントを作らず、同じアカウントの別のキーを使ってください。 |
| 402 | payment_required | チャージ(POST /account/topup)するか、範囲を絞ってください。 |
| 402 | over_budget | max_charge または月の支出上限を超えたため課金していません。上限を上げるか、範囲を絞るか、buy=false を使ってください。 |
| 402 | addon_required | 30日利用券(POST /addons/arbs)が必要です。 |
| 403 | suspended | このアカウントのAPI利用は停止されています。support@oddsbunch.com までお問い合わせください。 |
| 403 | not_on_sale | 有料機能は開いていません(まだ、または販売停止中 — 購入済みのものは引き続き使えます)。 |
| 403 | bad_origin | キーの発行・復旧は他サイトのページではなく、サーバー・ターミナルから行ってください。 |
| 404 | not_found | そのパスや試合はありません。または取得しないまま開始した試合です。 |
| 409 | key_limit_account · last_key · ambiguous_hint | 有効なキーが多すぎます(1つ廃止)・メールのないアカウントの最後のキー(本当に望み、残高が0のときだけ ?confirm=lose_account)・末尾4文字が同じキーが2つ(1つを交換)。 |
| 410 | cursor_expired | since なしで最初から(全ページ)取り直し、新しいカーソルで続けてください。 |
| 413 · 415 | body_too_large · unsupported_media | JSON本文は16KB未満で、Content-Type: application/json で送ってください。 |
| 429 | rate_limited | Retry-After 秒待ってください(limit_kind がどの上限かを示します)。 |
| 429 | free_daily_limit | 今日の無料試合を使い切りました。取得済みの試合は引き続き使えます。resets_at(00:00 UTC)に回復します。 |
| 429 | key_limit_ip | このIPから今日は新しいキーを取得しすぎています。手元のキーを使ってください。 |
| 500 | server | 間隔を空けて再試行してください。 |
| 503 | unavailable | Retry-After 秒後に再試行してください。 |
制限
| 無料キー | 有料キー | |
|---|---|---|
| リクエスト | オッズ・試合・結果は1時間 100回、メタ・見積もり・アカウント・注意事項は1時間 300回 | 1分 120回、同じ範囲の全体(デルタでない)リクエストは1分 2回 |
| 試合 | UTCの1日に新規 20試合 | 1日の上限なし(試合ごとに課金、月の上限あり) |
| データ | 5~10分遅れのスナップショット、メインライン | 最新(追加の遅延なし)、全ライン |
| 追加商品 | 成績表のみ | 独自オッズ・組み合わせ利用券・最終オッズ記録 |
| キー | IPごとに1日 3個まで新規 | — |
データが変わる速さより速く呼ばないでください:有料キーは60秒ごと程度、無料キーは 5分ごと。since を使えば毎回変わった試合だけが届きます。
エンドポイント
OpenAPI 仕様(openapi.json)から作った一覧です。カードごとに課金の種類・パラメーター・応答例。
/keys
Free key without sign-up
Billing: free
JSON body
{
"accept_notice": true,
"label": "string",
"lang": "string",
"via": "page"
}応答例
{
"ok": true,
"data": {
"key": "string",
"key_hint": "string",
"shown_once": true,
"tier": "string",
"limits": {
"delay_sec": 0,
"delay_max_sec": 0,
"daily_matches": 0,
"hourly_requests": 0,
"light_hourly_requests": 0,
"main_lines_only": true,
"scope_required": true
},
"notice": {
"version": "string",
"url": "string",
"summary": [
"string"
]
},
"warning": "string",
"next": [
{
"do": "string",
"request": "string"
}
],
"docs": {
"openapi": "string",
"markdown": "string",
"human": "string"
},
"revoked_hint": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/sports
Active sports
Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/leagues
Active leagues (ids for scopes)
Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
応答例
{
"ok": true,
"data": [
{
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/bookmakers
Bookmaker slugs
Billing: free
パラメータなし
応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/markets
Markets, outcomes, period, line_step
Billing: free
パラメータなし
応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/matches
Fixtures, status, scores (no odds)
Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| status | string | – | scheduled,live,finished,other |
応答例
{
"ok": true,
"data": [
{
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/results
Finished scores
Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
応答例
{
"ok": true,
"data": [
{
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/odds
Odds for not-yet-started matches in scope
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| since | string | – | Cursor from meta.cursor (delta) |
| changes_only | boolean | – | In a delta, only changed lines |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
応答例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"pass": "odds",
"source": "live",
"markets": [
{
"market": "…",
"lines": "…"
}
]
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/odds/{match_id}
One match, everything
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| match_id (path) | integer | * | |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
応答例
{
"ok": true,
"data": {
"match": {
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"pass": "odds",
"source": "live",
"markets": [
{
"market": "1x2",
"lines": [
"…"
]
}
]
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/quote
Cost preview, no charge
Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| product | string (odds | model | closing) | – |
応答例
{
"ok": true,
"data": {
"product": "string",
"tier": "string",
"matches_in_scope": 0,
"with_pass": 0,
"new_matches": 0,
"price": 0,
"cost": 0,
"month": "string",
"month_spent": 0,
"month_cap": 0,
"cap_left": 0,
"cap_reached_after": true,
"balance": 0,
"affordable_matches": 0,
"would_be_unpaid": 0,
"budget_month": 0,
"budget_spent": 0,
"budget_left": 0,
"over_budget": true,
"skipped": {
"no_odds": 0,
"filtered_out": 0,
"started": 0,
"free_daily_limit": 0
},
"free_left_today": 0,
"if_paid": {},
"note": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/model
Model odds (soccer 1X2)
Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
応答例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"model": "string",
"market": "string",
"p": {
"home": 0,
"draw": 0,
"away": 0
},
"fair": {
"home": 0,
"draw": 0,
"away": 0
},
"basis": "lineup",
"official": true,
"computed_at": "string",
"pre_complete": true,
"complete": true,
"history": [
{
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/model/{match_id}
Model odds for one match
Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| match_id (path) | integer | * | |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
応答例
{
"ok": true,
"data": {
"match": {
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"model": "string",
"market": "string",
"p": {
"home": 0,
"draw": 0,
"away": 0
},
"fair": {
"home": 0,
"draw": 0,
"away": 0
},
"basis": "lineup",
"official": true,
"computed_at": "string",
"pre_complete": true,
"complete": true,
"history": [
{
"p": {},
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/model/scorecard
Live record of the model
Billing: free
パラメータなし
応答例
{
"ok": true,
"data": {
"model": "string",
"what": "string",
"since": "string",
"updated_at": "string",
"groups": [
{
"basis": "string",
"data": "complete",
"n": 0,
"brier_model": 0,
"brier_market": 0,
"diff": 0,
"se": 0,
"verdict": "better",
"virtual_picks": {
"n": "…",
"roi": "…"
}
}
],
"notes": [
"string"
]
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/arbs
Arbitrage list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_payout | number | – |
応答例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"market": "string",
"line": 0,
"combined_payout_pct": 0,
"legs": [
{
"outcome": "…",
"side": "…",
"line": "…",
"bookmaker": "…",
"odds": "…",
"stake_share_pct": "…",
"changed_at": "…",
"age_sec": "…"
}
],
"oldest_leg_age_sec": 0,
"stale": true,
"verify": "string"
}
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/middles
Middles list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_miss | number | – |
応答例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"market": "string",
"window": {
"from": 0,
"to": 0
},
"legs": [
{
"outcome": "…",
"side": "…",
"line": "…",
"bookmaker": "…",
"odds": "…",
"stake_share_pct": "…",
"changed_at": "…",
"age_sec": "…"
}
],
"miss_payout_pct": 0,
"hit_payout_pct": 0,
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/spreads
Price gaps
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| outcome | string | – | |
| min_pct | number | – |
応答例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"market": "string",
"outcome": "string",
"best": {
"bookmaker": "string",
"odds": 0,
"changed_at": "string"
},
"median": 0,
"gap_pct": 0,
"books": 0
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/closing
Closing odds of finished matches
Not open yet (403 not_on_sale until paid access opens). Billing: closing pass per finished match (0.01 USDT, outside the cap)
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
応答例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"result": {},
"markets": [
{
"market": "…",
"lines": "…"
}
],
"taken_at": "string",
"source": "string"
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account
Balance, spend, caps, passes, keys
Billing: free
パラメータなし
応答例
{
"ok": true,
"data": {
"account": {
"kind": "anon",
"tier": "string",
"status": "string",
"suspended": true,
"email_linked": true,
"created_at": "string",
"withdrawable": true,
"paid_enabled": true
},
"balance": 0,
"month": "string",
"budget": {
"month_limit": 0,
"spent": 0,
"left": 0,
"budget_month": 0
},
"odds": {
"spent": 0,
"cap": 0,
"passes": 0,
"cap_by_month": [
{
"month": "…",
"spent": "…"
}
],
"free_today": {
"used": 0,
"limit": 0,
"resets_at": "string"
}
},
"model": {},
"closing": {},
"addons": [
{
"product": "arbs",
"status": "string",
"starts_at": "string",
"ends_at": "string",
"auto_renew": true,
"charged": 0,
"changed": "string"
}
],
"keys": [
{
"hint": "string",
"label": "string",
"created_at": "string",
"last_used_at": "string",
"current": true
}
],
"topup": {
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/passes
Passes of the account
Not open yet (403 not_on_sale until paid access opens). Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| month | string | – | |
| kind | string | – | |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/budget
Monthly spending limit
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"budget_month": 0
}応答例
{
"ok": true,
"data": {
"month_limit": 0,
"spent": 0,
"left": 0,
"budget_month": 0
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/topup
Deposit addresses (prepaid USDT)
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"accept_notice": true,
"network": "bsc"
}応答例
{
"ok": true,
"data": {
"on_sale": true,
"min": 0,
"networks": [
"string"
],
"addresses_issued": true,
"pending": [
{}
],
"not_credited": [
{
"network": "string",
"amount": 0,
"seen_at": "string",
"reason": "string"
}
],
"not_credited_total": 0,
"addresses": [
{
"network": "string",
"token": "string",
"address": "string",
"confirmations": 0,
"confirmation": "string",
"watch_until": "string"
}
],
"below_min": "string",
"credit": "string",
"withdraw_note": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/addons/arbs
30-day arbs subscription
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
JSON body
{
"auto_renew": true
}応答例
{
"ok": true,
"data": {
"product": "arbs",
"status": "string",
"starts_at": "string",
"ends_at": "string",
"auto_renew": true,
"charged": 0,
"changed": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/keys/rotate
New key for the same account
Billing: free
JSON body
{
"label": "string",
"keep_old": true
}応答例
{
"ok": true,
"data": {
"key": "string",
"key_hint": "string",
"shown_once": true,
"tier": "string",
"limits": {
"delay_sec": 0,
"delay_max_sec": 0,
"daily_matches": 0,
"hourly_requests": 0,
"light_hourly_requests": 0,
"main_lines_only": true,
"scope_required": true
},
"notice": {
"version": "string",
"url": "string",
"summary": [
"string"
]
},
"warning": "string",
"next": [
{
"do": "string",
"request": "string"
}
],
"docs": {
"openapi": "string",
"markdown": "string",
"human": "string"
},
"revoked_hint": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/keys/{hint}
Revoke a key by its last 4 characters
Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| hint (path) | string | * | |
| confirm | string (lose_account) | – |
応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email
Recovery email (sends a code)
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"email": "string"
}応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email/verify
Confirm the recovery email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"code": "string",
"old_code": "string"
}応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email/old-code
Code to the currently linked email
Not open yet (403 not_on_sale until paid access opens). Billing: free
パラメータなし
応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email
Unlink the recovery email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"old_code": "string"
}応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/recover
Start recovery with the linked email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"email": "string"
}応答例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/recover/verify
Finish recovery (new key)
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"email": "string",
"code": "string",
"accept_notice": true,
"label": "string"
}応答例
{
"ok": true,
"data": {
"key": "string",
"key_hint": "string",
"shown_once": true,
"tier": "string",
"limits": {
"delay_sec": 0,
"delay_max_sec": 0,
"daily_matches": 0,
"hourly_requests": 0,
"light_hourly_requests": 0,
"main_lines_only": true,
"scope_required": true
},
"notice": {
"version": "string",
"url": "string",
"summary": [
"string"
]
},
"warning": "string",
"next": [
{
"do": "string",
"request": "string"
}
],
"docs": {
"openapi": "string",
"markdown": "string",
"human": "string"
},
"revoked_hint": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/refund-address
Refund address during a shutdown notice
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"chain": "bsc",
"address": "string"
}応答例
{
"ok": true,
"data": {
"chain": "bsc",
"address": "string",
"ends_at": "string",
"fallback": "string",
"note": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/notice
Notice text (5 languages)
Billing: free
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
応答例
{
"ok": true,
"data": {
"version": "string",
"lang": "string",
"short": [
"string"
],
"items": [
"string"
],
"terms_url": "string",
"docs_url": "string",
"measured_delay": [
{
"sport": "string",
"p50_sec": 0,
"p90_sec": 0
}
]
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
…エラー応答: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
注意事項(正確性・遅延・責任)
- このデータは情報提供のみを目的としており、正確性・完全性・適時性を保証しません。
- オッズはブックメーカーのサイト上の実際の値と異なる場合があり、収集間隔や通信障害により遅れたり欠けたりすることがあります。通常はブックメーカーの更新から1分前後で反映されますが、遅い場合は数分かかります(競技別の実測値はドキュメント)。各行の changed_at・seen_at・age_sec を使って古い値をご自身で除外してください。
- 組み合わせ(アービトラージ)・ミドル・オッズ乖離は収集したオッズから機械的に計算した値のため、オッズの変更・停止・ブックメーカーのベット上限により実際には成立しない場合があります。
- 独自オッズ(oddsbunch-model-v1)は過去の試合記録から作った推定値であり、結果を保証しません。実戦の成績表を無料で公開しています。
- このデータに基づく判断とそれによる損失について、当サイトは責任を負いません。取得したデータを再販売したり、第三者へ再配布したりしないでください(規約 7-2 で認められた範囲の利用を除く)。
同意:POST /keys・POST /account/topup に "accept_notice": true。キーを取得すると、この注意事項と利用規約 7-2 に同意したものとみなします。
バージョン方針
v1 は増えるだけです:フィールド・エンドポイント・enum の値・エラーコードはいつでも追加することがあるため、知らないものは無視してください。互換性を壊す変更(フィールドの削除・名前の変更・意味や既定値の変更)は新しいバージョン(/api/data/v2)で出し、v1 は少なくとも90日間並行して動き、応答に Deprecation・Sunset ヘッダーが付きます。すべての変更は変更履歴(docs.md#changelog)に残り、現在のバージョンは meta.api_version です。ブックメーカー・競技・リーグの範囲の変化はバージョン変更ではありません(/meta/* で確認)。注意事項の文が変わると、新しいキーの発行・チャージのときに再度同意を求め、既存のキーには meta.notice_update で知らせます。