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:

  1. Get a key — POST https://oddsbunch.com/api/data/v1/keys with {"accept_notice": true}. No sign-up. The key (obd_…) is shown once.
  2. Pick a scope — GET /meta/sports, /meta/leagues?sport=soccer, /matches?league=… return our IDs.
  3. Check the cost, then fetch — GET /quote?league=… tells you how many new matches a call would charge, without charging. Then GET /odds?league=…, and keep polling with since=<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 -20

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, markets and main_only only 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 with 402 over_budget and 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 get 402 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:

FieldMeaning
changed_atWhen this price last changed (UTC).
seen_atWhen we last confirmed it in our collection.
age_secSeconds from changed_at to meta.generated_at (computed when the response is built).
suspendedtrue 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.

SportMedian90th pct.
Soccer42 s75 s
Ice Hockey39 s174 s
Esports43 s67 s
Basketball58 s—
American Football64 s168 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_…"
}
HTTPerrorWhat to do
400bad_scopeThe response lists the allowed parameters. Fix the query.
400bad_paramA parameter value is wrong; invalid lists which.
400notice_requiredSend "accept_notice": true (read GET /notice first).
400scope_required_freeFree keys must pick a scope (ids, sport, league or team).
400bad_jsonSend valid JSON.
401key_missing · key_invalidGet a key with POST /keys, or check the header.
401key_revokedThe key was revoked (reason). Use another key of the same account; don't create a new account.
402payment_requiredTop up (POST /account/topup) or narrow the scope.
402over_budgetOver max_charge or your monthly spending limit; nothing was charged. Raise the limit, narrow the scope or use buy=false.
402addon_requiredBuy the 30-day subscription (POST /addons/arbs).
403suspendedThis account's API access is suspended. Contact support@oddsbunch.com.
403not_on_salePaid features aren't open (yet, or sales are paused — what you already bought keeps working).
403bad_originCreate keys and recover from a server or a terminal, not from another site's page.
404not_foundNo such path or match, or it has started without a pass.
409key_limit_account · last_key · ambiguous_hintToo 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).
410cursor_expiredFetch again without since (all pages) and continue with the new cursor.
413 · 415body_too_large · unsupported_mediaKeep JSON bodies under 16 KB, send Content-Type: application/json.
429rate_limitedWait Retry-After seconds (limit_kind says which limit).
429free_daily_limitToday's free matches are used up; matches you already have still work. Resets at resets_at (00:00 UTC).
429key_limit_ipToo many new keys from this IP today; use the key you have.
500serverRetry with backoff.
503unavailableRetry after Retry-After seconds.

Limits

Free keyPaid key
Requests100 per hour for odds, matches and results; 300 per hour for meta, quote, account and notice120 per minute; full (non-delta) requests for the same scope 2 per minute
Matches20 new matches per UTC dayno daily count (billed per match, capped monthly)
Data5–10 minute old snapshot, main lineslatest (no added delay), all lines
Add-onsscorecard onlymodel odds, arbs subscription, closing odds
Keys3 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.

POST /keys Free

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

GET /meta/sports Free

Active sports

Billing: free

Parameters
NameTypeRequiredDescription
langstring (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

GET /meta/leagues Free

Active leagues (ids for scopes)

Billing: free

Parameters
NameTypeRequiredDescription
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
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

GET /meta/bookmakers Free

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

GET /meta/markets Free

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

GET /matches Free

Fixtures, status, scores (no odds)

Billing: free

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

GET /results Free

Finished scores

Billing: free

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

GET /odds Per match · 0.03 USDT

Odds for not-yet-started matches in scope

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

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

GET /odds/{match_id} Per match · 0.03 USDT

One match, everything

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

Parameters
NameTypeRequiredDescription
match_id (path)integer*
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
main_onlyboolean–Representative line only for handicap/totals (always true on free keys)
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
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

GET /quote Free

Cost preview, no charge

Billing: free

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

GET /model Model odds · per match · 0.01 USDT Paid — coming soon

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)

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

GET /model/{match_id} Model odds · per match · 0.01 USDT Paid — coming soon

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)

Parameters
NameTypeRequiredDescription
match_id (path)integer*
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
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

GET /model/scorecard Free

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

GET /arbs 30-day subscription · 5 USDT Paid — coming soon

Arbitrage list

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

Parameters
NameTypeRequiredDescription
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_payoutnumber–
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

GET /middles 30-day subscription · 5 USDT Paid — coming soon

Middles list

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

Parameters
NameTypeRequiredDescription
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_missnumber–
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

GET /spreads 30-day subscription · 5 USDT Paid — coming soon

Price gaps

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

Parameters
NameTypeRequiredDescription
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
outcomestring–
min_pctnumber–
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

GET /closing Per finished match · 0.01 USDT Paid — coming soon

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)

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

GET /account Free

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

GET /account/passes Free Paid — coming soon

Passes of the account

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

Parameters
NameTypeRequiredDescription
monthstring–
kindstring–
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–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

POST /account/budget Free Paid — coming soon

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

POST /account/topup Free Paid — coming soon

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

POST /addons/arbs 30-day subscription · 5 USDT Paid — coming soon

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

POST /keys/rotate Free

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

DELETE /keys/{hint} Free

Revoke a key by its last 4 characters

Billing: free

Parameters
NameTypeRequiredDescription
hint (path)string*
confirmstring (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

POST /account/link-email Free Paid — coming soon

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

POST /account/link-email/verify Free Paid — coming soon

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

POST /account/link-email/old-code Free Paid — coming soon

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

POST /account/recover Free Paid — coming soon

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

POST /account/recover/verify Free Paid — coming soon

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

POST /account/refund-address Free Paid — coming soon

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

GET /notice Free

Notice text (5 languages)

Billing: free

Parameters
NameTypeRequiredDescription
langstring (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)

  1. This data is provided for information only. We do not guarantee its accuracy, completeness or timeliness.
  2. 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.
  3. 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.
  4. 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.
  5. 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).

Terms §7-2 Data API use →

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.