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.
| Product | Price | Terms |
|---|---|---|
| Odds (latest, no added delay) | 0.03 USDT / match | All bookmakers, markets and lines; closing odds and result after kick-off included · 49 USDT monthly cap · Measured latency → |
| Model odds | +0.01 USDT / match | Soccer 1X2 probabilities and fair odds · 9 USDT monthly cap |
| Arbs, middles & price gaps | 5 USDT / 30 days | Full lists with filters · 30-day subscription, optional auto-renew |
| Closing odds history | 0.01 USDT / match | Each bookmaker's closing price for finished matches (main lines) · outside the monthly cap (counts toward your spending limit) |
| Free | 0 | 5–10 min old snapshot · main lines only · 20 matches a day · 100 requests an hour |
| Scope | Matches / month | Cost |
|---|---|---|
| 5 specific matches | 5 | 0.15 USDT |
| Friendly International only | about 91 | about 2.73 USDT |
| All Soccer | about 699 | about 20.97 USDT |
| Everything | about 2240 | Cap: 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
This key is shown only once. Copy it and keep it somewhere safe. If you lose it, just get a new free key (3 per IP address per 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"import os, requests
H = {"Authorization": f"Bearer {os.environ['ODDSBUNCH_KEY']}"}
r = requests.get("https://oddsbunch.com/api/data/v1/odds", params={"league": 386, "limit": 5}, headers=H, timeout=30).json()
print(r["billing"], len(r["data"]))const H = { Authorization: `Bearer ${process.env.ODDSBUNCH_KEY}` };
const r = await (await fetch("https://oddsbunch.com/api/data/v1/odds?league=386&limit=5", { headers: H })).json();
console.log(r.billing, r.data.length);
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 matches | No clear difference | Brier difference +0.0045 ± 0.0059 |
| Incomplete data, 244 matches | Worse than bookmakers | Brier difference +0.0469 ± 0.0126 |
| Values without confirmed line-ups (time), 101 matches | Worse than bookmakers | Brier 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.