赔率数据 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 得到通知。