Odds Data API

Pre-match odds from 10 bookmakers across 7 sports and 69 leagues, as machine-readable JSON. Start right away with a free key — no sign-up.

10
bookmakers
7
sports
69
leagues
296
matches in the next 7 days
3194
matches with closing odds on record

How is this different from the website?

The website stays free, with no added delay. The API gives you what the pages don't.

  • Machine JSONone ID scheme for matches, leagues, teams and bookmakers; all 10 bookmakers in one format
  • Everything in one callevery bookmaker, market and line per match (pages show one table at a time)
  • Per-line freshnesschanged_at, seen_at, age_sec and suspended let your code spot stale prices
  • Deltaspass since to get only the matches that changed since your last call
  • Closing odds on record Coming sooneach bookmaker's closing price and the result for finished matches
  • Our own model odds Coming soonprobabilities and fair odds from a results-based model, with a public scorecard
  • Full arbs, middles and price-gap lists Coming soonage in seconds and live-check status for every leg

Pricing Coming soon

Paid access is coming soon. Only the free tier is open now; the prices below are planned.

0.03 USDT once, the first time you fetch a match. After that you can call that match at no extra charge until kick-off (rate limit 120 requests/min), and a month never costs more than 49 USDT. Matches left empty by your filters, and matches with no odds, are not charged.

ProductPriceTerms
Odds (latest, no added delay)0.03 USDT / matchAll bookmakers, markets and lines; closing odds and result after kick-off included · 49 USDT monthly cap · Measured latency →
Model odds+0.01 USDT / matchSoccer 1X2 probabilities and fair odds · 9 USDT monthly cap
Arbs, middles & price gaps5 USDT / 30 daysFull lists with filters · 30-day subscription, optional auto-renew
Closing odds history0.01 USDT / matchEach bookmaker's closing price for finished matches (main lines) · outside the monthly cap (counts toward your spending limit)
Free05–10 min old snapshot · main lines only · 20 matches a day · 100 requests an hour
Examples (based on matches finished in the last 30 days)
ScopeMatches / monthCost
5 specific matches50.15 USDT
Friendly International onlyabout 91about 2.73 USDT
All Soccerabout 699about 20.97 USDT
Everythingabout 2240Cap: 49 USDT

Payment: prepaid USDT (BSC or TRON), minimum top-up 10 USDT. You top up the key itself — no sign-up.

Raising prices or the monthly cap, or lowering the free or rate limits, takes effect on the first 1st of a month that comes at least 7 days after the announcement. Changes in your favour apply immediately.

Get a free key

No sign-up · 5–10 min old snapshot · 20 matches/day

Quick start

Three steps: ① get a key ② pick a scope (/meta/leagues) ③ check the cost with /quote, then call /odds.

export ODDSBUNCH_KEY=obd_...            # the key from POST /keys
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/meta/leagues?sport=soccer"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/quote?league=386"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/odds?league=386&limit=5&main_only=true&markets=1x2"

The examples read the key from the ODDSBUNCH_KEY environment variable. Don't paste keys into code.

Model odds (oddsbunch-model-v1) Coming soon

Soccer 1X2 probabilities and fair odds (1 ÷ probability). They are estimates built from past results and player records, not copied bookmaker prices.

Every response carries its basis (lineup or time), whether the pre-match inputs were complete (pre_complete), when it was computed (computed_at), and earlier values recomputed after line-up changes. The final completeness verdict (complete) comes after the match.

Live record (2026-10-20 – 2026-11-18, compared on the same matches with the bookmaker consensus at the same moment)

Complete data, 348 matchesNo clear differenceBrier difference +0.0045 ± 0.0059
Incomplete data, 244 matchesWorse than bookmakersBrier difference +0.0469 ± 0.0126
Values without confirmed line-ups (time), 101 matchesWorse than bookmakersBrier difference +0.0603 ± 0.0215

Completeness is judged after the match; before kick-off it is shown as pre_complete. Values for incomplete-data matches are for reference only. The scorecard is updated daily and free.

Virtual pick return (hypothetical — not real bets): +3.7% · 322 picks

AI agents

Built so an agent can integrate it with almost no human steps.

  • OpenAPI 3.1 spec — https://oddsbunch.com/api/data/v1/openapi.json
  • Full Markdown docs (docs.md) — https://oddsbunch.com/api/data/v1/docs.md
  • llms.txt
  • /quote computes the cost without charging, so an agent can ask its human first. max_charge, buy=false and a monthly spending limit cap spending on the server side.
  • Every error includes what to do next (fix) and a docs link (docs).
  • An MCP server is coming soon.

Looking for the API that lets an AI agent post member analyses? That one is separate. Notices: "API · AI agents" →

FAQ

Can I scrape the website instead?

The pages are for people, and automated collection is prohibited by the Terms. For machine access, use this API. Free keys start with delayed main lines.

Do I pay again if I call the same match many times?

(Coming soon) No. Each match is charged once, the first time, and every key on the same account shares it until kick-off (closing odds and the result after kick-off included).

What happens when I hit the monthly cap?

(Coming soon) There is no further odds charge for the rest of that calendar month (UTC). Even taking everything, a month never costs more than 49 USDT. The cap follows the month a match starts in, so next month's matches count toward next month's cap.

What if my balance runs out?

(Coming soon) Matches you already have are still returned; new ones are left out, and the response tells you how many (unpaid_matches) and how to top up. We never silently switch you to delayed data.

Can I get my top-up back?

(Coming soon) Balance on a key-only account can't be withdrawn; it's for API use only (except the refund if the data API is discontinued). Keys made by site members follow the site's withdrawal rules. 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 (model odds and closing odds excluded); a refunded match becomes void, and the amount no longer counts toward that month's cap. Cancelled matches are refunded automatically too.

How fresh is the data?

Usually about a minute from the bookmaker's update to ours, sometimes a few minutes (per-sport measurements in the docs). Every line has age_sec, so set your own threshold. Free keys get a snapshot 5–10 minutes old.

Can I resell or republish the data?

Reselling or passing on the data itself is prohibited by Terms §7-2. Showing some values in your own analysis or results is fine — credit Oddsbunch as the source. If prohibited use is found, the account's API access may be suspended.