Odds Data API reference
Endpoints, billing, freshness and errors on one page. The machine-readable docs say the same thing.
For machines: openapi.json · docs.md · llms.txt
Getting started
Three steps:
- Get a key —
POST https://oddsbunch.com/api/data/v1/keyswith{"accept_notice": true}. No sign-up. The key (obd_…) is shown once. - Pick a scope —
GET /meta/sports,/meta/leagues?sport=soccer,/matches?league=…return our IDs. - Check the cost, then fetch —
GET /quote?league=…tells you how many new matches a call would charge, without charging. ThenGET /odds?league=…, and keep polling withsince=<meta.cursor>to receive only matches that changed.
Paid access is not open yet; every key is a free key for now.
Cost rule: new matches × 0.03 USDT, never more than 49 USDT per UTC calendar month. A match you already have is free until kick-off.
Free keys get a 5–10 minute old snapshot, main lines only, 20 matches a day and 100 requests an hour, and must pick a scope (ids, sport, league or team). Tip while exploring: limit=5&main_only=true&markets=1x2. Base URL: https://oddsbunch.com/api/data/v1.
Pages and deltas: follow meta.next_page until it is null; every page carries the same meta.cursor, and you use that cursor for the next since call only after taking all pages. On 410 cursor_expired, fetch everything again (all pages) without 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);
}
Authentication
Send the key in one of two headers: Authorization: Bearer obd_… or X-API-Key: obd_…. Never put it in the URL. We store only a hash of the key, so a lost key can't be shown again — if you linked an email, recover the account with POST /account/recover; otherwise get a new free key (a new key is a new account: passes and balance don't move). To replace a working key call POST /keys/rotate (the key you call it with is revoked unless you send "keep_old": true); DELETE /keys/{hint} revokes one key. A revoked key answers 401 key_revoked with a reason — use another key of the same account rather than creating a new one. Keys on the same account share everything you've paid for. Reading endpoints send Access-Control-Allow-Origin: *, so browser code can call them; creating keys and recovery don't (call those from a server or a terminal). Don't ship a paid key inside a public web page.
Billing and the monthly cap
Paid access is not open yet; every key is a free key for now.
- Odds: the first time your account receives a match, it is charged 0.03 USDT once. After that, every key on the account can fetch that match — all bookmakers, markets and lines — as often as the rate limit allows until kick-off; closing odds and the result after kick-off are included.
- Monthly cap: once the odds charges for matches starting in a UTC calendar month reach 49 USDT, no further odds charge applies to that month's matches. The cap follows the month a match starts in, so next month's matches count toward next month's cap. A request that crosses the cap is charged only the remainder.
- Filters:
bookmakers,marketsandmain_onlyonly shrink the response and don't change the price. A match your filters leave empty, and a match with no odds, is not charged (skipped: filtered_out/no_odds). - Budgets you control:
max_charge=<USDT>on a request,buy=false(only matches you already have), and a monthly spending limit across all products (POST /account/budget). A request that would exceed them is refused with402 over_budgetand nothing is charged. - Add-ons: model odds +0.01 USDT per match (cap 9); arbs/middles/price-gaps pass 5 USDT per 30 days; closing odds history 0.01 USDT per finished match (outside the cap).
- Not enough balance: matches you already have are still returned; new matches you can't pay for are left out and their IDs listed in
billing.unpaid_matches(HTTP 200). If every requested match is new and unpaid, you get402 payment_required. We never quietly switch a paid account to delayed data. - Every response carries
billing:charged,new_matches,balance,month_spent,month_cap,free_left_today. - Prepaid USDT: top up with
POST /account/topup(BSC or TRON, minimum 10 USDT). Balance on a key-only account can't be withdrawn. If you bought a match, or it kicked off, while our collection was stopped and its odds weren't updated during the stop (you got frozen data), the odds charge is refunded automatically after kick-off (not model odds or closing odds); a refunded match becomes void (fetching it again is charged again) and the amount no longer counts toward the cap. Cancelled matches are refunded too; postponed matches keep the same ID and pass. - Raising prices or the cap, or lowering the free or rate limits, takes effect on the first 1st of a month at least 7 days after it is announced; changes in your favour apply at once.
Freshness fields
Every price line carries four fields so your code can decide what is too old:
| Field | Meaning |
|---|---|
| changed_at | When this price last changed (UTC). |
| seen_at | When we last confirmed it in our collection. |
| age_sec | Seconds from changed_at to meta.generated_at (computed when the response is built). |
| suspended | true if the bookmaker has taken the line off; the last value is kept. |
Soccer and American football are received incrementally, so for an unchanged line seen_at can lag by up to 10 minutes; use changed_at/age_sec for staleness. book_marked_main is the line the bookmaker marks as its main line; main on a line group is the representative line we pick. Percent fields end in _pct (e.g. combined_payout_pct); roi is a ratio. Free keys get a snapshot rebuilt every 5 minutes and served only once it is at least 5 minutes old, so meta.delay_sec is between 300 and about twice that. Arbitrage combinations also give the age of every leg, the age of the oldest leg, and for combinations at 105% or more a verify state: same (matched the bookmaker's live price), diff, unverifiable or pending.
Measured latency
Time from the bookmaker's own update time to our changed_at, measured on recent data. Typical delay is about a minute; occasionally several minutes.
| Sport | Median | 90th pct. |
|---|---|---|
| Soccer | 42 s | 75 s |
| Ice Hockey | 39 s | 174 s |
| Esports | 43 s | 67 s |
| Basketball | 58 s | — |
| American Football | 64 s | 168 s |
Measured 2026-11-18 · last 2 hours · bookmaker update time → our update time
Errors
Errors always look like this, so an agent can recover without a human:
{
"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 | What to do |
|---|---|---|
| 400 | bad_scope | The response lists the allowed parameters. Fix the query. |
| 400 | bad_param | A parameter value is wrong; invalid lists which. |
| 400 | notice_required | Send "accept_notice": true (read GET /notice first). |
| 400 | scope_required_free | Free keys must pick a scope (ids, sport, league or team). |
| 400 | bad_json | Send valid JSON. |
| 401 | key_missing · key_invalid | Get a key with POST /keys, or check the header. |
| 401 | key_revoked | The key was revoked (reason). Use another key of the same account; don't create a new account. |
| 402 | payment_required | Top up (POST /account/topup) or narrow the scope. |
| 402 | over_budget | Over max_charge or your monthly spending limit; nothing was charged. Raise the limit, narrow the scope or use buy=false. |
| 402 | addon_required | Buy the 30-day subscription (POST /addons/arbs). |
| 403 | suspended | This account's API access is suspended. Contact support@oddsbunch.com. |
| 403 | not_on_sale | Paid features aren't open (yet, or sales are paused — what you already bought keeps working). |
| 403 | bad_origin | Create keys and recover from a server or a terminal, not from another site's page. |
| 404 | not_found | No such path or match, or it has started without a pass. |
| 409 | key_limit_account · last_key · ambiguous_hint | Too many active keys (revoke one) · last key of an account with no email (?confirm=lose_account only if you really mean it and the balance is 0) · two keys share those 4 characters (rotate one). |
| 410 | cursor_expired | Fetch again without since (all pages) and continue with the new cursor. |
| 413 · 415 | body_too_large · unsupported_media | Keep JSON bodies under 16 KB, send Content-Type: application/json. |
| 429 | rate_limited | Wait Retry-After seconds (limit_kind says which limit). |
| 429 | free_daily_limit | Today's free matches are used up; matches you already have still work. Resets at resets_at (00:00 UTC). |
| 429 | key_limit_ip | Too many new keys from this IP today; use the key you have. |
| 500 | server | Retry with backoff. |
| 503 | unavailable | Retry after Retry-After seconds. |
Limits
| Free key | Paid key | |
|---|---|---|
| Requests | 100 per hour for odds, matches and results; 300 per hour for meta, quote, account and notice | 120 per minute; full (non-delta) requests for the same scope 2 per minute |
| Matches | 20 new matches per UTC day | no daily count (billed per match, capped monthly) |
| Data | 5–10 minute old snapshot, main lines | latest (no added delay), all lines |
| Add-ons | scorecard only | model odds, arbs subscription, closing odds |
| Keys | 3 new keys per IP per day | — |
Poll no faster than the data changes: about every 60 seconds for paid keys, every 5 minutes for free keys. Use since so each poll returns only changed matches.
Endpoints
Generated from the OpenAPI spec (https://oddsbunch.com/api/data/v1/openapi.json). Each card shows the charge type, parameters and a sample response.
/keys
Free key without sign-up
Billing: free
JSON body
{
"accept_notice": true,
"label": "string",
"lang": "string",
"via": "page"
}Sample response
{
"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,
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/sports
Active sports
Billing: free
| Name | Type | Required | Description |
|---|---|---|---|
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
Sample response
{
"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
],
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/leagues
Active leagues (ids for scopes)
Billing: free
| Name | Type | Required | Description |
|---|---|---|---|
| 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) |
Sample response
{
"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",
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/bookmakers
Bookmaker slugs
Billing: free
No parameters
Sample response
{
"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
],
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/meta/markets
Markets, outcomes, period, line_step
Billing: free
No parameters
Sample response
{
"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
],
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/matches
Fixtures, status, scores (no odds)
Billing: free
| Name | Type | Required | Description |
|---|---|---|---|
| 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 |
Sample response
{
"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"
}
],
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/results
Finished scores
Billing: free
| Name | Type | Required | Description |
|---|---|---|---|
| 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 |
Sample response
{
"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"
}
],
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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 |
Sample response
{
"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": [
{
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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) |
Sample response
{
"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": [
{
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/quote
Cost preview, no charge
Billing: free
| Name | Type | Required | Description |
|---|---|---|---|
| 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) | – |
Sample response
{
"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",
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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 |
Sample response
{
"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": [
{
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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) |
Sample response
{
"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": {},
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/model/scorecard
Live record of the model
Billing: free
No parameters
Sample response
{
"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"
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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 | – |
Sample response
{
"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"
}
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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 | – |
Sample response
{
"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,
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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 | – |
Sample response
{
"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"
}
],
…Error responses: 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)
| Name | Type | Required | Description |
|---|---|---|---|
| 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 |
Sample response
{
"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": [
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/account
Balance, spend, caps, passes, keys
Billing: free
No parameters
Sample response
{
"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": {
…Error responses: 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
| Name | Type | Required | Description |
|---|---|---|---|
| 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 |
Sample response
{
"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
],
…Error responses: 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
}Sample response
{
"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,
…Error responses: 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"
}Sample response
{
"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",
…Error responses: 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
}Sample response
{
"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"
…Error responses: 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
}Sample response
{
"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,
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/keys/{hint}
Revoke a key by its last 4 characters
Billing: free
| Name | Type | Required | Description |
|---|---|---|---|
| hint (path) | string | * | |
| confirm | string (lose_account) | – |
Sample response
{
"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
],
…Error responses: 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"
}Sample response
{
"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
],
…Error responses: 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"
}Sample response
{
"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
],
…Error responses: 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
No parameters
Sample response
{
"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
],
…Error responses: 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"
}Sample response
{
"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
],
…Error responses: 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"
}Sample response
{
"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
],
…Error responses: 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"
}Sample response
{
"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,
…Error responses: 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"
}Sample response
{
"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": {
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
/notice
Notice text (5 languages)
Billing: free
| Name | Type | Required | Description |
|---|---|---|---|
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
Sample response
{
"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",
…Error responses: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503
Notice (accuracy, delays, liability)
- This data is provided for information only. We do not guarantee its accuracy, completeness or timeliness.
- Odds may differ from the bookmaker's own site and may arrive late or be missing because of collection intervals or network problems. They usually reflect a bookmaker's update within about a minute, but sometimes take several minutes (per-sport measurements are in the docs). Use the changed_at, seen_at and age_sec fields on every line to filter stale prices yourself.
- Arbitrage combinations, middles and price gaps are calculated mechanically from collected odds, so they may not actually be available because of price changes, suspensions or bookmaker stake limits.
- Our own model odds (oddsbunch-model-v1) are estimates built from past match records and do not guarantee any outcome. Their live scorecard is published free of charge.
- We are not responsible for decisions made with this data or for any resulting loss. Do not resell the data or redistribute it to others (except use allowed under Terms §7-2).
Agreeing: send "accept_notice": true with POST /keys and POST /account/topup; getting a key means you agree to this notice and Terms §7-2.
Versioning
v1 only grows: we may add fields, endpoints, enum values and error codes at any time — ignore anything you don't recognise. Breaking changes (removing or renaming a field, changing its meaning or a default) go to a new version (/api/data/v2), and v1 keeps working for at least 90 days alongside it, with Deprecation and Sunset headers on v1 responses. Every change is listed in the changelog (docs.md#changelog); meta.api_version tells you the current version. Coverage changes (bookmakers, sports, leagues) are not version changes — check /meta/*. When the notice text changes, new keys and top-ups ask for agreement again and existing keys see meta.notice_update.