賠率資料 API 文件

端點、計費、新鮮度與錯誤集中在一頁。機器可讀文件內容相同。

機器可讀: openapi.json · docs.md · llms.txt

入門

三個步驟:

  1. 獲取金鑰 — 向 POST https://oddsbunch.com/api/data/v1/keys 傳送 {"accept_notice": true}。無需註冊。金鑰(obd_…)只顯示一次。
  2. 選擇範圍 — GET /meta/sports、/meta/leagues?sport=soccer、/matches?league=… 返回本站 ID。
  3. 先確認費用再獲取 — GET /quote?league=… 在不扣費的情況下告訴您將新扣費的比賽數。然後呼叫 GET /odds?league=…,之後帶上 since=<meta.cursor> 只接收有變化的比賽。

付費使用尚未開放,目前所有金鑰都是免費金鑰。

費用規則: 新比賽數 × 0.03 USDT,每個 UTC 自然月不超過 49 USDT。已獲取的比賽在開賽前不再扣費。

免費金鑰提供 5~10 分鐘前的快照,僅主線,每天 20 場比賽、每小時 100 次請求,並且必須選擇一個範圍(ids、sport、league 或 team)。探索時可用 limit=5&main_only=true&markets=1x2,比較輕量。基礎地址: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 -20

認證

金鑰通過以下任一請求頭髮送:Authorization: Bearer obd_… 或 X-API-Key: obd_…。不要放在網址(查詢參數)裡。本站只儲存金鑰的雜湊,丟失的金鑰無法再次顯示——如已綁定信箱,可用 POST /account/recover 找回帳戶;否則請獲取新的免費金鑰(新金鑰 = 新帳戶,已購比賽和餘額不會轉移)。要更換正在使用的金鑰,呼叫 POST /keys/rotate(呼叫時所用的金鑰會立即作廢,除非傳送 "keep_old": true);作廢單個金鑰用 DELETE /keys/{hint}。已作廢的金鑰返回 401 key_revoked 和 reason——請使用同一帳戶的其他金鑰,不要新建帳戶。同一帳戶的金鑰共享所有已購內容。讀取類端點返回 Access-Control-Allow-Origin: *,瀏覽器代碼也能呼叫;建立金鑰和找回不開放 CORS(請從伺服器或終端呼叫)。不要把付費金鑰放進公開網頁。

計費與月上限

付費使用尚未開放,目前所有金鑰都是免費金鑰。

  • 賠率: 帳戶第一次獲取某場比賽時扣費 0.03 USDT,只扣一次。之後帳戶的所有金鑰都可以在開賽前、在請求限額內隨時獲取這場比賽(所有博彩公司、所有盤口、所有盤線),開賽後的收盤賠率和結果也包含在內。
  • 月度上限: 某 UTC 自然月開賽的比賽,賠率扣費達到 49 USDT 後,該月比賽不再扣費。上限按比賽開賽的月份計算,下個月的比賽計入下個月的上限。跨越上限的請求只扣剩餘部分。
  • 篩選: bookmakers、markets、main_only 只縮小響應,不改變價格。篩選後一行也不剩的比賽和沒有賠率的比賽不扣費(skipped: filtered_out / no_odds)。
  • 自己設定的限額: 每次請求的 max_charge=<USDT>、只取已有比賽的 buy=false,以及所有產品合計的月度支出上限(POST /account/budget)。超出的請求會以 402 over_budget 拒絕,不扣費。
  • 附加產品: 自有賠率每場 +0.01 USDT(上限 9);組合·中間盤·偏差 30 天使用權 5 USDT;收盤賠率記錄每場已結束比賽 0.01 USDT(不計入上限)。
  • 餘額不足時: 已有的比賽照常返回;無法支付的新比賽會被略去,其 ID 列在 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 日起生效;對您有利的變更立即生效。

新鮮度欄位

每一行賠率都帶有四個欄位,方便您的代碼判斷資料是否過舊:

欄位含義
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 與其兩倍左右之間。組合還會給出每條腿的經過秒數和最舊一條腿的經過秒數,105% 及以上的組合另附 verify 狀態:same(與博彩公司即時價格一致)、diff、unverifiable 或 pending。

實測延遲

從博彩公司自身的更新時間到我們的 changed_at 所經過的時間(基於近期資料實測)。通常約 1 分鐘,偶爾需要幾分鐘。

專案中位數90%
足球42 秒75 秒
冰球39 秒174 秒
電子競技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_…"
}
HTTPerror怎麼做
400bad_scope響應中列出了允許的參數,請修正查詢。
400bad_param某個參數值有誤;invalid 會列出是哪個。
400notice_required傳送 "accept_notice": true(請先閱讀 GET /notice)。
400scope_required_free免費金鑰必須選擇一個範圍(ids、sport、league 或 team)。
400bad_json請傳送有效的 JSON。
401key_missing · key_invalid用 POST /keys 獲取金鑰,或檢查請求頭。
401key_revoked該金鑰已作廢(reason)。請使用同一帳戶的其他金鑰,不要新建帳戶。
402payment_required儲值(POST /account/topup)或縮小範圍。
402over_budget超過了 max_charge 或月度支出上限,未扣費。請提高限額、縮小範圍或使用 buy=false。
402addon_required需要購買 30 天使用權(POST /addons/arbs)。
403suspended此帳戶的 API 使用已被停用。請聯絡 support@oddsbunch.com。
403not_on_sale付費功能尚未開放(還沒開放,或已暫停銷售——已購內容仍可繼續使用)。
403bad_origin請從伺服器或終端建立金鑰和找回,不要在其他網站的頁面中進行。
404not_found沒有這個路徑或比賽,或該比賽已開賽而您之前未獲取過。
409key_limit_account · last_key · ambiguous_hint有效金鑰過多(作廢一個)· 沒有信箱的帳戶的最後一個金鑰(只有確實需要且餘額為 0 時才用 ?confirm=lose_account)· 兩個金鑰的末 4 位相同(更換其中一個)。
410cursor_expired不帶 since 從頭重新獲取(所有頁),再用新游標繼續。
413 · 415body_too_large · unsupported_mediaJSON 請求體請小於 16 KB,併發送 Content-Type: application/json。
429rate_limited等待 Retry-After 秒(limit_kind 說明是哪種限額)。
429free_daily_limit今天的免費比賽已用完;已獲取的比賽仍可使用。於 resets_at(00:00 UTC)重置。
429key_limit_ip今天從這個 IP 建立的新金鑰太多;請使用已有的金鑰。
500server請稍後加大間隔重試。
503unavailable請在 Retry-After 秒後重試。

限制

免費金鑰付費金鑰
請求賠率、比賽和結果每小時 100 次;後設資料、報價、帳戶和須知每小時 300 次每分鐘 120 次;同一範圍的完整(非增量)請求每分鐘 2 次
比賽每個 UTC 日 20 場新比賽不按日計數(按場計費,月度封頂)
資料5~10 分鐘前的快照,主線最新(無額外延遲),所有盤線
附加產品僅成績表自有賠率、組合使用權、收盤賠率
金鑰每個 IP 每天 3 個新金鑰—

輪詢不要快於資料變化的速度:付費金鑰約每 60 秒一次,免費金鑰每 5 分鐘一次。使用 since,每次只返回有變化的比賽。

端點

根據 OpenAPI 規範(openapi.json)生成。每張卡片顯示計費類型、參數和示例響應。

POST /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

GET /meta/sports 免費

Active sports

Billing: free

引數
名稱型別必填說明
langstring (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

GET /meta/leagues 免費

Active leagues (ids for scopes)

Billing: free

引數
名稱型別必填說明
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
langstring (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

GET /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

GET /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

GET /matches 免費

Fixtures, status, scores (no odds)

Billing: free

引數
名稱型別必填說明
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
fromstring–UTC date or date-time
tostring–UTC date or date-time
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
statusstring–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

GET /results 免費

Finished scores

Billing: free

引數
名稱型別必填說明
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
datestring–UTC day YYYY-MM-DD
fromstring–UTC date or date-time
tostring–UTC date or date-time
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–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

GET /odds 按場計費 · 0.03 USDT

Odds for not-yet-started matches in scope

Billing: odds pass per new match (0.03 USDT, monthly cap 49)

引數
名稱型別必填說明
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
hoursinteger–Matches starting within N hours (default 168)
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
main_onlyboolean–Representative line only for handicap/totals (always true on free keys)
sincestring–Cursor from meta.cursor (delta)
changes_onlyboolean–In a delta, only changed lines
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–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

GET /odds/{match_id} 按場計費 · 0.03 USDT

One match, everything

Billing: odds pass per new match (0.03 USDT, monthly cap 49)

引數
名稱型別必填說明
match_id (path)integer*
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
main_onlyboolean–Representative line only for handicap/totals (always true on free keys)
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (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

GET /quote 免費

Cost preview, no charge

Billing: free

引數
名稱型別必填說明
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
hoursinteger–Matches starting within N hours (default 168)
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
productstring (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

GET /model 自有賠率 · 按場計費 · 0.01 USDT 付費 — 即將推出

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)

引數
名稱型別必填說明
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–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

GET /model/{match_id} 自有賠率 · 按場計費 · 0.01 USDT 付費 — 即將推出

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_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (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

GET /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

GET /arbs 30 天使用權 · 5 USDT 付費 — 即將推出

Arbitrage list

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

引數
名稱型別必填說明
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_payoutnumber–
響應示例
{
  "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

GET /middles 30 天使用權 · 5 USDT 付費 — 即將推出

Middles list

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

引數
名稱型別必填說明
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_missnumber–
響應示例
{
  "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

GET /spreads 30 天使用權 · 5 USDT 付費 — 即將推出

Price gaps

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

引數
名稱型別必填說明
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
outcomestring–
min_pctnumber–
響應示例
{
  "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

GET /closing 每場已結束比賽 · 0.01 USDT 付費 — 即將推出

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)

引數
名稱型別必填說明
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
datestring–UTC day YYYY-MM-DD
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–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

GET /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

GET /account/passes 免費 付費 — 即將推出

Passes of the account

Not open yet (403 not_on_sale until paid access opens). Billing: free

引數
名稱型別必填說明
monthstring–
kindstring–
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–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

POST /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

POST /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

POST /addons/arbs 30 天使用權 · 5 USDT 付費 — 即將推出

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

POST /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

DELETE /keys/{hint} 免費

Revoke a key by its last 4 characters

Billing: free

引數
名稱型別必填說明
hint (path)string*
confirmstring (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

POST /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

POST /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

POST /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

POST /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

POST /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

POST /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

GET /notice 免費

Notice text (5 languages)

Billing: free

引數
名稱型別必填說明
langstring (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. 本資料僅供參考,不保證其準確性、完整性或及時性。
  2. 賠率可能與博彩公司網站上的實際數值不同,也可能因採集週期或網路問題而延遲或缺失。通常在博彩公司更新後約 1 分鐘內同步,慢時需要幾分鐘(各專案實測見檔案)。請使用每行附帶的 changed_at、seen_at、age_sec 自行過濾過時資料。
  3. 組合(套利)、中間盤與賠率偏差是根據採集到的賠率機械計算的結果,可能因賠率變化、暫停或博彩公司的投注限額而實際無法成立。
  4. 自有賠率(oddsbunch-model-v1)是基於歷史比賽記錄得出的估計值,不保證任何結果。其實戰成績表免費公開。
  5. 對於依據本資料作出的決定及由此產生的任何損失,本站概不負責。請勿轉售所獲取的資料,或將其再分發給他人(條款第 7-2 條允許範圍內的使用除外)。

服務條款第 7-2 條 資料 API 使用 →

同意方式:在 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 得到通知。