赔率数据 API 文档
端点、计费、新鲜度与错误集中在一页。机器可读文档内容相同。
机器可读: openapi.json · docs.md · llms.txt
入门
三个步骤:
- 获取密钥 — 向
POST https://oddsbunch.com/api/data/v1/keys发送{"accept_notice": true}。无需注册。密钥(obd_…)只显示一次。 - 选择范围 —
GET /meta/sports、/meta/leagues?sport=soccer、/matches?league=…返回本站 ID。 - 先确认费用再获取 —
GET /quote?league=…在不扣费的情况下告诉您将新扣费的比赛数。然后调用GET /odds?league=…,之后带上since=<meta.cursor>只接收有变化的比赛。
付费使用尚未开放,目前所有密钥都是免费密钥。
费用规则: 新比赛数 × 0.03 USDT,每个 UTC 自然月不超过 49 USDT。已获取的比赛在开赛前不再扣费。
免费密钥提供 5~10 分钟前的快照,仅主线,每天 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 -20import os, time, requests
BASE = "https://oddsbunch.com/api/data/v1"
def get_key():
# Free key, no sign-up. Store it safely; it cannot be shown again.
r = requests.post(f"{BASE}/keys", json={"accept_notice": True}, timeout=30)
r.raise_for_status()
return r.json()["data"]["key"]
KEY = os.environ.get("ODDSBUNCH_KEY") or get_key()
S = requests.Session()
S.headers["Authorization"] = f"Bearer {KEY}" # requests sends Accept-Encoding: gzip by default
class CursorExpired(Exception):
pass
def call(path, **params):
while True:
r = S.get(f"{BASE}{path}", params=params, timeout=30)
if r.status_code == 429: # rate limited
time.sleep(int(r.headers.get("Retry-After", "60")))
continue
body = r.json()
if r.status_code == 410: # cursor_expired: start over without since
raise CursorExpired()
if r.status_code == 401: # key_missing / key_invalid / key_revoked
raise SystemExit(f"Key problem: {body['error']} -> {body['fix']}")
if r.status_code == 402: # payment_required / over_budget
raise SystemExit(f"{body['error']}: {body['message']} -> {body['fix']}")
if not body.get("ok"):
raise RuntimeError(f"{body['error']}: {body['message']} ({body['docs']})")
return body
def fetch_all(**params):
"""All pages of one request. Every page has the same meta.cursor."""
items, removed, cursor, token = [], [], None, None
while True:
page = call("/odds", **params, **({"page_token": token} if token else {}))
cursor = page["meta"]["cursor"]
items += page["data"]
removed += page.get("data_removed", [])
token = page["meta"]["next_page"]
if not token:
return items, removed, cursor, page["meta"]["tier"]
leagues = call("/meta/leagues", sport="soccer")["data"]
league_id = leagues[0]["id"]
quote = call("/quote", league=league_id)["data"]
print("new matches:", quote["new_matches"], "cost:", quote["cost"], "USDT")
# An agent should ask its human before a large charge (or pass max_charge=…).
seen = set() # de-duplicate lines across deltas
items, _, cursor, tier = fetch_all(league=league_id)
for item in items:
m = item["match"]
print(m["id"], m["home"]["name"], "vs", m["away"]["name"])
while True:
time.sleep(60 if tier == "paid" else 300) # free snapshots are rebuilt every 5 min
try:
items, removed, cursor, tier = fetch_all(league=league_id, since=cursor)
except CursorExpired:
items, removed, cursor, tier = fetch_all(league=league_id) # start over (all pages)
for item in items:
for mk in item["markets"]:
for ln in mk["lines"]:
for b in ln["books"]:
k = (item["match"]["id"], b["bookmaker"], mk["market"], ln["line"], b["changed_at"])
if k not in seen:
seen.add(k)
print("changed:", k)
for r in removed:
print("removed:", r["id"], r["reason"])const BASE = "https://oddsbunch.com/api/data/v1";
async function getKey() {
// Free key, no sign-up (call from a server or a terminal). Store it safely; it cannot be shown again.
const r = await fetch(`${BASE}/keys`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ accept_notice: true }),
});
if (!r.ok) throw new Error(`key: HTTP ${r.status}`);
return (await r.json()).data.key;
}
const KEY = process.env.ODDSBUNCH_KEY || (await getKey());
const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
class CursorExpired extends Error {}
async function call(path, params = {}) {
const url = `${BASE}${path}?${new URLSearchParams(params)}`;
for (;;) {
const r = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } }); // fetch handles gzip
if (r.status === 429) { await sleep(1000 * Number(r.headers.get("Retry-After") || 60)); continue; }
const body = await r.json();
if (r.status === 410) throw new CursorExpired();
if (r.status === 401) throw new Error(`Key problem: ${body.error} -> ${body.fix}`);
if (r.status === 402) throw new Error(`${body.error}: ${body.message} -> ${body.fix}`);
if (!body.ok) throw new Error(`${body.error}: ${body.message} (${body.docs})`);
return body;
}
}
async function fetchAll(params) {
// All pages of one request share meta.cursor; use it only after the last page.
let items = [], removed = [], token = null, page;
do {
page = await call("/odds", token ? { ...params, page_token: token } : params);
items = items.concat(page.data);
removed = removed.concat(page.data_removed || []);
token = page.meta.next_page;
} while (token);
return { items, removed, cursor: page.meta.cursor, tier: page.meta.tier };
}
const leagues = (await call("/meta/leagues", { sport: "soccer" })).data;
const league = leagues[0].id;
const quote = (await call("/quote", { league })).data;
console.log("new matches:", quote.new_matches, "cost:", quote.cost, "USDT");
let res = await fetchAll({ league });
console.log(res.items.length, "matches");
for (;;) {
await sleep(res.tier === "paid" ? 60_000 : 300 * 1000);
try {
res = await fetchAll({ league, since: res.cursor });
} catch (e) {
if (!(e instanceof CursorExpired)) throw e;
res = await fetchAll({ league }); // start over (all pages)
}
for (const item of res.items) console.log("changed:", item.match.id);
for (const r of res.removed) console.log("removed:", r.id, r.reason);
}
认证
密钥通过以下任一请求头发送:Authorization: Bearer obd_… 或 X-API-Key: obd_…。不要放在网址(查询参数)里。本站只保存密钥的哈希,丢失的密钥无法再次显示——如已绑定邮箱,可用 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_…"
}
| HTTP | error | 怎么做 |
|---|---|---|
| 400 | bad_scope | 响应中列出了允许的参数,请修正查询。 |
| 400 | bad_param | 某个参数值有误;invalid 会列出是哪个。 |
| 400 | notice_required | 发送 "accept_notice": true(请先阅读 GET /notice)。 |
| 400 | scope_required_free | 免费密钥必须选择一个范围(ids、sport、league 或 team)。 |
| 400 | bad_json | 请发送有效的 JSON。 |
| 401 | key_missing · key_invalid | 用 POST /keys 获取密钥,或检查请求头。 |
| 401 | key_revoked | 该密钥已作废(reason)。请使用同一账户的其他密钥,不要新建账户。 |
| 402 | payment_required | 充值(POST /account/topup)或缩小范围。 |
| 402 | over_budget | 超过了 max_charge 或月度支出上限,未扣费。请提高限额、缩小范围或使用 buy=false。 |
| 402 | addon_required | 需要购买 30 天使用权(POST /addons/arbs)。 |
| 403 | suspended | 此账户的 API 使用已被停用。请联系 support@oddsbunch.com。 |
| 403 | not_on_sale | 付费功能尚未开放(还没开放,或已暂停销售——已购内容仍可继续使用)。 |
| 403 | bad_origin | 请从服务器或终端创建密钥和找回,不要在其他网站的页面中进行。 |
| 404 | not_found | 没有这个路径或比赛,或该比赛已开赛而您之前未获取过。 |
| 409 | key_limit_account · last_key · ambiguous_hint | 有效密钥过多(作废一个)· 没有邮箱的账户的最后一个密钥(只有确实需要且余额为 0 时才用 ?confirm=lose_account)· 两个密钥的末 4 位相同(更换其中一个)。 |
| 410 | cursor_expired | 不带 since 从头重新获取(所有页),再用新游标继续。 |
| 413 · 415 | body_too_large · unsupported_media | JSON 请求体请小于 16 KB,并发送 Content-Type: application/json。 |
| 429 | rate_limited | 等待 Retry-After 秒(limit_kind 说明是哪种限额)。 |
| 429 | free_daily_limit | 今天的免费比赛已用完;已获取的比赛仍可使用。于 resets_at(00:00 UTC)重置。 |
| 429 | key_limit_ip | 今天从这个 IP 创建的新密钥太多;请使用已有的密钥。 |
| 500 | server | 请稍后加大间隔重试。 |
| 503 | unavailable | 请在 Retry-After 秒后重试。 |
限制
| 免费密钥 | 付费密钥 | |
|---|---|---|
| 请求 | 赔率、比赛和结果每小时 100 次;元数据、报价、账户和须知每小时 300 次 | 每分钟 120 次;同一范围的完整(非增量)请求每分钟 2 次 |
| 比赛 | 每个 UTC 日 20 场新比赛 | 不按日计数(按场计费,月度封顶) |
| 数据 | 5~10 分钟前的快照,主线 | 最新(无额外延迟),所有盘线 |
| 附加产品 | 仅成绩表 | 自有赔率、组合使用权、收盘赔率 |
| 密钥 | 每个 IP 每天 3 个新密钥 | — |
轮询不要快于数据变化的速度:付费密钥约每 60 秒一次,免费密钥每 5 分钟一次。使用 since,每次只返回有变化的比赛。
端点
根据 OpenAPI 规范(openapi.json)生成。每张卡片显示计费类型、参数和示例响应。
/keys
Free key without sign-up
Billing: free
JSON body
{
"accept_notice": true,
"label": "string",
"lang": "string",
"via": "page"
}响应示例
{
"ok": true,
"data": {
"key": "string",
"key_hint": "string",
"shown_once": true,
"tier": "string",
"limits": {
"delay_sec": 0,
"delay_max_sec": 0,
"daily_matches": 0,
"hourly_requests": 0,
"light_hourly_requests": 0,
"main_lines_only": true,
"scope_required": true
},
"notice": {
"version": "string",
"url": "string",
"summary": [
"string"
]
},
"warning": "string",
"next": [
{
"do": "string",
"request": "string"
}
],
"docs": {
"openapi": "string",
"markdown": "string",
"human": "string"
},
"revoked_hint": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/sports
Active sports
Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/leagues
Active leagues (ids for scopes)
Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
响应示例
{
"ok": true,
"data": [
{
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/bookmakers
Bookmaker slugs
Billing: free
无参数
响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/markets
Markets, outcomes, period, line_step
Billing: free
无参数
响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/matches
Fixtures, status, scores (no odds)
Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| status | string | – | scheduled,live,finished,other |
响应示例
{
"ok": true,
"data": [
{
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/results
Finished scores
Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
响应示例
{
"ok": true,
"data": [
{
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/odds
Odds for not-yet-started matches in scope
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| since | string | – | Cursor from meta.cursor (delta) |
| changes_only | boolean | – | In a delta, only changed lines |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
响应示例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"pass": "odds",
"source": "live",
"markets": [
{
"market": "…",
"lines": "…"
}
]
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/odds/{match_id}
One match, everything
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| match_id (path) | integer | * | |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
响应示例
{
"ok": true,
"data": {
"match": {
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"pass": "odds",
"source": "live",
"markets": [
{
"market": "1x2",
"lines": [
"…"
]
}
]
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/quote
Cost preview, no charge
Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| product | string (odds | model | closing) | – |
响应示例
{
"ok": true,
"data": {
"product": "string",
"tier": "string",
"matches_in_scope": 0,
"with_pass": 0,
"new_matches": 0,
"price": 0,
"cost": 0,
"month": "string",
"month_spent": 0,
"month_cap": 0,
"cap_left": 0,
"cap_reached_after": true,
"balance": 0,
"affordable_matches": 0,
"would_be_unpaid": 0,
"budget_month": 0,
"budget_spent": 0,
"budget_left": 0,
"over_budget": true,
"skipped": {
"no_odds": 0,
"filtered_out": 0,
"started": 0,
"free_daily_limit": 0
},
"free_left_today": 0,
"if_paid": {},
"note": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/model
Model odds (soccer 1X2)
Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
响应示例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"model": "string",
"market": "string",
"p": {
"home": 0,
"draw": 0,
"away": 0
},
"fair": {
"home": 0,
"draw": 0,
"away": 0
},
"basis": "lineup",
"official": true,
"computed_at": "string",
"pre_complete": true,
"complete": true,
"history": [
{
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/model/{match_id}
Model odds for one match
Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| match_id (path) | integer | * | |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
响应示例
{
"ok": true,
"data": {
"match": {
"id": 0,
"sport": "string",
"league": {
"id": 0,
"sport": "string",
"name": "string",
"name_en": "string",
"country": "string",
"upcoming_7d": 0
},
"home": {
"id": 0,
"name": "string",
"name_en": "string"
},
"away": {
"id": 0,
"name": "string",
"name_en": "string"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": 0,
"away": 0
},
"score_regular": {
"home": 0,
"away": 0
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"model": "string",
"market": "string",
"p": {
"home": 0,
"draw": 0,
"away": 0
},
"fair": {
"home": 0,
"draw": 0,
"away": 0
},
"basis": "lineup",
"official": true,
"computed_at": "string",
"pre_complete": true,
"complete": true,
"history": [
{
"p": {},
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/model/scorecard
Live record of the model
Billing: free
无参数
响应示例
{
"ok": true,
"data": {
"model": "string",
"what": "string",
"since": "string",
"updated_at": "string",
"groups": [
{
"basis": "string",
"data": "complete",
"n": 0,
"brier_model": 0,
"brier_market": 0,
"diff": 0,
"se": 0,
"verdict": "better",
"virtual_picks": {
"n": "…",
"roi": "…"
}
}
],
"notes": [
"string"
]
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/arbs
Arbitrage list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_payout | number | – |
响应示例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"market": "string",
"line": 0,
"combined_payout_pct": 0,
"legs": [
{
"outcome": "…",
"side": "…",
"line": "…",
"bookmaker": "…",
"odds": "…",
"stake_share_pct": "…",
"changed_at": "…",
"age_sec": "…"
}
],
"oldest_leg_age_sec": 0,
"stale": true,
"verify": "string"
}
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/middles
Middles list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_miss | number | – |
响应示例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"market": "string",
"window": {
"from": 0,
"to": 0
},
"legs": [
{
"outcome": "…",
"side": "…",
"line": "…",
"bookmaker": "…",
"odds": "…",
"stake_share_pct": "…",
"changed_at": "…",
"age_sec": "…"
}
],
"miss_payout_pct": 0,
"hit_payout_pct": 0,
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/spreads
Price gaps
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| outcome | string | – | |
| min_pct | number | – |
响应示例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"market": "string",
"outcome": "string",
"best": {
"bookmaker": "string",
"odds": 0,
"changed_at": "string"
},
"median": 0,
"gap_pct": 0,
"books": 0
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/closing
Closing odds of finished matches
Not open yet (403 not_on_sale until paid access opens). Billing: closing pass per finished match (0.01 USDT, outside the cap)
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
响应示例
{
"ok": true,
"data": [
{
"match": {
"id": 0,
"sport": "string",
"league": {
"id": "…",
"sport": "…",
"name": "…",
"name_en": "…",
"country": "…",
"upcoming_7d": "…"
},
"home": {
"id": "…",
"name": "…",
"name_en": "…"
},
"away": {
"id": "…",
"name": "…",
"name_en": "…"
},
"start_time": "string",
"status": "scheduled",
"status_detail": "string",
"score": {
"home": "…",
"away": "…"
},
"score_regular": {
"home": "…",
"away": "…"
},
"url": "string",
"bookmakers": 0,
"has_odds": true,
"has_model": true
},
"result": {},
"markets": [
{
"market": "…",
"lines": "…"
}
],
"taken_at": "string",
"source": "string"
}
],
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account
Balance, spend, caps, passes, keys
Billing: free
无参数
响应示例
{
"ok": true,
"data": {
"account": {
"kind": "anon",
"tier": "string",
"status": "string",
"suspended": true,
"email_linked": true,
"created_at": "string",
"withdrawable": true,
"paid_enabled": true
},
"balance": 0,
"month": "string",
"budget": {
"month_limit": 0,
"spent": 0,
"left": 0,
"budget_month": 0
},
"odds": {
"spent": 0,
"cap": 0,
"passes": 0,
"cap_by_month": [
{
"month": "…",
"spent": "…"
}
],
"free_today": {
"used": 0,
"limit": 0,
"resets_at": "string"
}
},
"model": {},
"closing": {},
"addons": [
{
"product": "arbs",
"status": "string",
"starts_at": "string",
"ends_at": "string",
"auto_renew": true,
"charged": 0,
"changed": "string"
}
],
"keys": [
{
"hint": "string",
"label": "string",
"created_at": "string",
"last_used_at": "string",
"current": true
}
],
"topup": {
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/passes
Passes of the account
Not open yet (403 not_on_sale until paid access opens). Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| month | string | – | |
| kind | string | – | |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/budget
Monthly spending limit
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"budget_month": 0
}响应示例
{
"ok": true,
"data": {
"month_limit": 0,
"spent": 0,
"left": 0,
"budget_month": 0
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/topup
Deposit addresses (prepaid USDT)
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"accept_notice": true,
"network": "bsc"
}响应示例
{
"ok": true,
"data": {
"on_sale": true,
"min": 0,
"networks": [
"string"
],
"addresses_issued": true,
"pending": [
{}
],
"not_credited": [
{
"network": "string",
"amount": 0,
"seen_at": "string",
"reason": "string"
}
],
"not_credited_total": 0,
"addresses": [
{
"network": "string",
"token": "string",
"address": "string",
"confirmations": 0,
"confirmation": "string",
"watch_until": "string"
}
],
"below_min": "string",
"credit": "string",
"withdraw_note": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/addons/arbs
30-day arbs subscription
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
JSON body
{
"auto_renew": true
}响应示例
{
"ok": true,
"data": {
"product": "arbs",
"status": "string",
"starts_at": "string",
"ends_at": "string",
"auto_renew": true,
"charged": 0,
"changed": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/keys/rotate
New key for the same account
Billing: free
JSON body
{
"label": "string",
"keep_old": true
}响应示例
{
"ok": true,
"data": {
"key": "string",
"key_hint": "string",
"shown_once": true,
"tier": "string",
"limits": {
"delay_sec": 0,
"delay_max_sec": 0,
"daily_matches": 0,
"hourly_requests": 0,
"light_hourly_requests": 0,
"main_lines_only": true,
"scope_required": true
},
"notice": {
"version": "string",
"url": "string",
"summary": [
"string"
]
},
"warning": "string",
"next": [
{
"do": "string",
"request": "string"
}
],
"docs": {
"openapi": "string",
"markdown": "string",
"human": "string"
},
"revoked_hint": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/keys/{hint}
Revoke a key by its last 4 characters
Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| hint (path) | string | * | |
| confirm | string (lose_account) | – |
响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email
Recovery email (sends a code)
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"email": "string"
}响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email/verify
Confirm the recovery email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"code": "string",
"old_code": "string"
}响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email/old-code
Code to the currently linked email
Not open yet (403 not_on_sale until paid access opens). Billing: free
无参数
响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/link-email
Unlink the recovery email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"old_code": "string"
}响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/recover
Start recovery with the linked email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"email": "string"
}响应示例
{
"ok": true,
"data": null,
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
"charged": 0,
"new_matches": 0,
"kind": "odds",
"unpaid_matches": [
0
],
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/recover/verify
Finish recovery (new key)
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"email": "string",
"code": "string",
"accept_notice": true,
"label": "string"
}响应示例
{
"ok": true,
"data": {
"key": "string",
"key_hint": "string",
"shown_once": true,
"tier": "string",
"limits": {
"delay_sec": 0,
"delay_max_sec": 0,
"daily_matches": 0,
"hourly_requests": 0,
"light_hourly_requests": 0,
"main_lines_only": true,
"scope_required": true
},
"notice": {
"version": "string",
"url": "string",
"summary": [
"string"
]
},
"warning": "string",
"next": [
{
"do": "string",
"request": "string"
}
],
"docs": {
"openapi": "string",
"markdown": "string",
"human": "string"
},
"revoked_hint": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account/refund-address
Refund address during a shutdown notice
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"chain": "bsc",
"address": "string"
}响应示例
{
"ok": true,
"data": {
"chain": "bsc",
"address": "string",
"ends_at": "string",
"fallback": "string",
"note": "string"
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
"lang": "string"
},
"request_id": "string",
"api_version": "string",
"notice_update": {
"version": "string",
"url": "string"
},
"snapshot": "string",
"notice": "string"
},
"billing": {
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/notice
Notice text (5 languages)
Billing: free
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
响应示例
{
"ok": true,
"data": {
"version": "string",
"lang": "string",
"short": [
"string"
],
"items": [
"string"
],
"terms_url": "string",
"docs_url": "string",
"measured_delay": [
{
"sport": "string",
"p50_sec": 0,
"p90_sec": 0
}
]
},
"skipped": [
{
"id": 0,
"reason": "not_found",
"fix": "string"
}
],
"data_added": [
{
"id": 0,
"reason": "entered_window"
}
],
"data_removed": [
{
"id": 0,
"reason": "started"
}
],
"meta": {
"generated_at": "string",
"data_as_of": "string",
"delay_sec": 0,
"tier": "free",
"notice_url": "string",
"docs": "string",
"docs_html": "string",
"cursor": "string",
"next_page": "string",
"applied": {
"main_only": true,
"markets": [
"string"
],
"bookmakers": "all",
"hours": 0,
"buy": true,
"max_charge": 0,
"sport": "string",
…错误响应: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
须知(准确性、延迟、责任)
- 本数据仅供参考,不保证其准确性、完整性或及时性。
- 赔率可能与博彩公司网站上的实际数值不同,也可能因采集周期或网络问题而延迟或缺失。通常在博彩公司更新后约 1 分钟内同步,慢时需要几分钟(各项目实测见文档)。请使用每行附带的 changed_at、seen_at、age_sec 自行过滤过时数据。
- 组合(套利)、中间盘与赔率偏差是根据采集到的赔率机械计算的结果,可能因赔率变化、暂停或博彩公司的投注限额而实际无法成立。
- 自有赔率(oddsbunch-model-v1)是基于历史比赛记录得出的估计值,不保证任何结果。其实战成绩表免费公开。
- 对于依据本数据作出的决定及由此产生的任何损失,本站概不负责。请勿转售所获取的数据,或将其再分发给他人(条款第 7-2 条允许范围内的使用除外)。
同意方式:在 POST /keys 和 POST /account/topup 中发送 "accept_notice": true;获取密钥即视为同意本须知和服务条款第 7-2 条。
版本策略
v1 只增不减:我们随时可能新增字段、端点、enum 值和错误码——不认识的请忽略。破坏性变更(删除或重命名字段、改变含义或默认值)会以新版本(/api/data/v2)发布,v1 至少并行运行 90 天,其响应带有 Deprecation 和 Sunset 请求头。所有变更都记录在变更日志(docs.md#changelog)中;meta.api_version 表示当前版本。覆盖范围变化(博彩公司、项目、联赛)不算版本变更——请查看 /meta/*。须知文字变更时,新密钥发放和充值会再次征得同意,现有密钥会通过 meta.notice_update 得到通知。