API documentation
Every endpoint is a GET request to https://api.oddsrelay.io with your API key in a header. A call costs tokens, set by the product and the filters you send, never by the size of the reply. A historical odds day file is the exception: it is priced per MB.
API version 2026-07-08 · Changelog
Quickstart
Get a key. Sign up free. Your first API key is shown once when you finish, so copy it then. Save it as the environment variable ODDSRELAY_KEY.
Make your first call. Football match odds (sports=soccer, markets=h2h) in UK & Ireland, on the standard product:
# --compressed asks for gzip and decompresses it for you. BASE=https://api.oddsrelay.io curl --compressed -sS -D - \ -H "Authorization: Bearer $ODDSRELAY_KEY" \ "$BASE/v2/odds/standard?region=uk&sports=soccer&markets=h2h"This call costs 1,107 tokens (pricing). Try it in the request tool
Check the price first. Add quote=true to any odds request to get its cost without running it. Quotes are free.
BASE=https://api.oddsrelay.io curl --compressed -s -H "Authorization: Bearer $ODDSRELAY_KEY" \ "$BASE/v2/odds/standard?region=uk&sports=soccer"e=true" # {"cost": 5400, "remaining": …, "rate_card": "…"}Poll without paying twice. Send the last ETag back as If-None-Match. If nothing has changed you get a 304 with no body, and it costs no tokens.
# Send the last ETag back exactly as you got it, quotes included: # ETAG='"c1f97f865-4517-gz"' BASE=https://api.oddsrelay.io curl --compressed -s -o /dev/null -w "%{http_code}\n" \ -H "Authorization: Bearer $ODDSRELAY_KEY" \ -H "If-None-Match: $ETAG" \ "$BASE/v2/odds/standard?region=uk&sports=soccer&markets=h2h"
For a complete client with retries and polling, see Example client.
Authentication
Send your key in the Authorization header as Bearer <key>, or in x-api-key. Never put it in the query string.
Server keys start or_live_: keep them on your server and out of code repositories. Browser keys start or_pub_, come with the Enterprise plan, and only work on the websites listed on the key.
No key is needed for /healthz, /v2/status, /v2/openapi.json, or the public view of /v2/coverage.
Regions
Odds endpoints take one region code. Available today: uk (UK & Ireland), au (Australia), ca (Canada), cd (DR Congo), ci (Côte d'Ivoire), cm (Cameroon), gh (Ghana), global (Global), gr (Greece), ke (Kenya), mw (Malawi), mz (Mozambique), ng (Nigeria), nz (New Zealand), rw (Rwanda), sn (Senegal), tz (Tanzania), ug (Uganda), us (United States), za (South Africa), zm (Zambia). Without one, a call means uk only if your account's home region (the main region chosen at sign-up) is uk and the key reads it; any other key gets a 400 naming a code to send. Regions says what each serves. Send one lowercase code; a list, a repeat or an uppercase code returns 400. GET /v2/odds/raw alone takes several international codes in one call, as in region=us,global (uk is asked alone). Discovery endpoints read it too, defaulting to uk; /v2/regions, /v2/health, /v2/usage, /v2/pricing and /v2/openapi.json take none. GET /v2/regions lists the regions your key covers.
Endpoints
All endpoints are GET requests to https://api.oddsrelay.io. Try opens the call in your dashboard's request tool, which shows its cost before it runs. You need to be signed in.
| Endpoint | Returns | Cost |
|---|---|---|
| /v2/odds/{type} | Matched odds for one product, the whole board in one reply. Try | Tokens |
| /v2/odds/raw | Every bookmaker's and exchange's prices, a page at a time. Try | Tokens |
| /v2/odds/event/{id} | Raw prices for one event | Tokens |
| /v2/sports | Sports and competitions, with their markets | Free |
| /v2/events | Events for a sport | Free |
| /v2/events/state | Whether each event is still on: its state now, a page at a time (free) | Free |
| /v2/events/changes | Every change to an event's state, in order, since your last call (free) | Free |
| /v2/bookmakers | Bookmakers and exchanges | Free |
| /v2/regions | Regions your key covers | Free |
| /v2/coverage | What each bookmaker and exchange covers, by sport | Free |
| /v2/status | Service status per product (no key needed) | Free |
| /v2/spotlight | The home page's display data, not for integration: build on the matched boards (no key needed) | Free |
| /v2/health | How recently each product was updated | Free |
| /v2/usage | Your plan, token balance and rate limits | Free |
| /v2/pricing | The token price table | Free |
| /v2/openapi.json | The OpenAPI 3.1 contract (no key needed) | Free |
| /healthz | Returns 200 when the API is up (no key needed) | Free |
| /v2/historical/odds/raw | Bookmakers' and exchanges' raw odds as they stood at a past instant, a page at a time | Tokens |
| /v2/historical/events/{id}/odds | One event's price changes over a window | Tokens |
| /v2/historical/closing | Closing lines for the events that kicked off on one UTC day | Tokens |
| /v2/historical/files | The historical day files, with sizes and prices (free) | Free |
| /v2/historical/files/{tier}/{sport}/{file} | One historical day file, as gzipped CSV | Tokens |
Products
GET /v2/odds/{type} returns matched odds for one product: the whole board in one reply, every event your filters keep, with no paging. Each event lists its markets, each market its outcomes, and each outcome the best back prices from bookmakers beside the best lay prices from exchanges.
| Product | What it holds | Try |
|---|---|---|
| standard | Every bookmaker's back price beside the best exchange lay price, event by event. Try | Try |
| 2up | Football prices from bookmakers' 2Up markets, beside the lay for the same team. Try | Try |
| dutching | Back prices covering every outcome of a market, grouped into ready-made dutches. Try | Try |
| each-way | Horse racing prices with each bookmaker's each-way terms, and both lays. Try | Try |
| extra-place | Only the races where a bookmaker pays more places than the exchange. Try | Try |
| bog | Win prices from bookmakers offering best odds guaranteed on a race. Try | Try |
| raw | Every bookmaker's and exchange's prices, unmatched, 250 events a page. Try | Try |
On each-way and extra-place, lay is split into win and place. dutching has no lay prices; its back legs share a dutch_id. Prices don't include exchange commission: apply your own rate when you work out ratings and lay stakes.
standard, dutching and raw also serve the events in play, through inPlay. 2up, each-way, extra-place and bog are pre-match only. See In-play prices.
One dutching set from the feed right now: its legs, one outcome each at a different bookmaker, and the rating worked out from them.
Event ids are the same on every endpoint and never change once served. If two ids turn out to be one fixture, the one served first is kept and the other is listed in that event's previous_ids, on every live route, matched boards included; it still answers on /v2/odds/event/{id} and in eventIds while that event is on the board, and again if its fixture is listed again within 60 days. A race names its course in venue, and an event with no two teams that is not a race its name in event_name. See Stable event ids.
Raw odds
GET /v2/odds/raw returns every bookmaker's and exchange's prices per event, up to 250 events a page, ordered by kick-off. Follow meta.next_cursor for the next page. A cursor expires after 300 seconds; if it does, start again from the first page. Deduplicate by event id. Add updatedSince to get only what changed: its first page's meta.removed lists what left the board. See Following changes.
Historical odds
GET /v2/historical/odds/raw returns the raw board as it stood at a past instant, /v2/historical/events/{id}/odds one event's price changes and /v2/historical/closing a day's closing lines; /v2/historical/files lists the day files to download. The board, event and closing calls hold bookmakers and exchanges, or the bookmakers alone with bookmakersOnly=true, and the day files hold both. Priced per page of a reply, or per MB of a day file. See Historical odds and the product page.
Discovery
/v2/sports, /v2/events, /v2/bookmakers and /v2/regions are free and list the values the filters accept. /v2/events lists every event the API serves, raw's included, with has_coverage naming the matched boards that carry it ([] for an event only raw serves), and eventIds looks up any id, a merged one included. See Looking an event up.
What a reply carries
| Field | Description |
|---|---|
| meta.processed_at | When the reply was built, also sent as X-Processed-At. |
| meta.last_seen | When each bookmaker and sport was last read. The time since then is the most a price can have aged, except at William Hill, whose prices can be older. |
| meta.count | Events in data. |
| X-OddsRelay-Version | A response header, not a field: which version of the data you were served, the same on every endpoint for one publish. |
Prices carry no timestamp of their own; use meta.last_seen. A bookmaker not read within its own window, at most 150 seconds (300 for bet365), is left out until it is read again. See How fresh a price is.
Filters
Send several values as one comma-separated list, as in sports=soccer,tennis, and each parameter once: a repeat returns 400.
| Parameter | Max values | Returns only |
|---|---|---|
| sports | 20 | Events in these sports or competitions (a sport key, a prefix such as soccer, or an event's competition_key) |
| bookmakers | 40 | Back prices from these bookmakers |
| exchanges | 4 | Lay prices from these exchanges |
| markets | 20 | These markets, such as h2h |
| commenceTimeFrom, commenceTimeTo | – | Events kicking off in this window (ISO 8601, UTC) |
| inPlay | – | With only, the events in play alone (standard and dutching) |
Filtering never changes a price: you get the full product with the rest removed. An outcome left with no back or no lay price is dropped, then any empty market or event. On dutching, each market's best set is built from the bookmakers and exchanges you named alone. An unknown value returns 400 with the valid values listed. A valid value with nothing on today returns an empty reply, which is free. For one event, use /v2/odds/event/{id}.
Tokens
Each account has one pool of tokens: a paid plan's resets every month, and the free plan gives 50,000 tokens for 14 days. A call's price depends on the product and the filters, never on the size of the reply, except a historical odds day file, priced per MB. GET /v2/pricing returns the price table, Pricing explains it with examples, and quote=true prices any request for free.
Free: discovery endpoints, /v2/usage, /v2/pricing, the historical odds files list (/v2/historical/files), quotes, 304 replies, empty replies and every error. A call that costs more than your balance returns 402 insufficient_tokens and nothing is charged. The body includes cost, plan, quote, rate_card, remaining, resets_at and upgrade_url, so you can narrow the filters or choose a plan. On a paid plan, waiting for the reset also works; on the free plan's window, the reset is its end and no tokens follow it. On a custom Enterprise plan there is no upgrade_url.
| Header | Description |
|---|---|
| X-Tokens-Cost | What this reply cost; 0 when it was free. Sent on every reply to a valid key. |
| X-Tokens-Used | Tokens used this period. |
| X-Tokens-Remaining | Tokens left this period, or unlimited. |
| X-Tokens-Limit | Your allowance for the period, or unlimited. |
| X-Tokens-Reset | When the allowance resets (ISO 8601, UTC). On the free plan's window or a trial, its end if that is sooner; no tokens follow it. |
The last four are sent whenever the balance is known, so treat them as optional. See Tokens, quotes and rate limits, and Polling for fewer tokens before you put a call in a loop.
Rate limits
Each account is limited per 10 seconds, per minute, and in concurrent requests; GET /v2/usage shows your limits. Going over returns 429 too_many_requests with a Retry-After header. Every authenticated request counts, including 304s. Before a key is checked, each IP address has its own limit (429 too_many_from_address). Historical day files download one at a time per account (and only a few across all accounts); one more returns 429 too_many_downloads at once, with a Retry-After header.
| Header | Description |
|---|---|
| X-RateLimit-Limit | Your limit for the window closest to running out: 10 seconds or 1 minute. |
| X-RateLimit-Remaining | Requests left in that window. |
| X-RateLimit-Reset | Seconds until that window resets. |
| Retry-After | On every 429 and 503: seconds to wait. Never sent on a 402. |
Our edge also limits each IP address and the service as a whole. Its 429 and 502 replies have an empty body and no error code; honour Retry-After and back off.
Compression and caching
Send Accept-Encoding: gzip (the quickstart's --compressed does this) to get bodies over 1 kB compressed. Without it you get plain bodies. standard, dutching, raw and /v2/historical/odds/raw refuse a request that rules gzip out (Accept-Encoding: identity) with a 400. Python's urllib sends that by default, so set Accept-Encoding: gzip yourself. /healthz, /v2/status, /v2/health, /v2/usage, quotes and errors are always plain.
Odds replies, /v2/sports, /v2/events, /v2/bookmakers and historical day files carry an ETag. Send it back exactly as you received it, quotes included, in If-None-Match. If nothing has changed you get 304 with no body: it costs no tokens but still counts towards your rate limit. A call your balance can't cover returns 402 even with If-None-Match.
Errors
Errors return JSON: {"error": {"code", "message", "request_id"}}, plus any extra fields listed below. Branch on code, not message, which may change.
| Status | Code | When |
|---|---|---|
| 400 | bad_request | A parameter the route does not read or sent twice, a malformed value, an expired cursor, or gzip refused on standard, dutching, raw and /v2/historical/odds/raw |
| 400 | date_out_of_range | A historical odds date before the archive starts or not yet released Also returns: earliest, latest |
| 400 | missing_param | Required parameter missing |
| 400 | region_required | No region and the key lacks uk |
| 400 | sport_not_served_by_this_worker | A standard call whose sports reached a worker holding only one sport's rows: a routing fault on our side, never your query; send it again Also returns: valid |
| 400 | unknown_bookmaker | Unknown bookmaker (valid trimmed) Also returns: valid |
| 400 | unknown_exchange | A bookmaker named in exchanges Also returns: valid |
| 400 | unknown_market | Unknown market on this product, carried by others (valid trimmed) Also returns: products, valid |
| 400 | unknown_sport | Unknown sport (valid trimmed) Also returns: valid |
| 401 | expired_api_key | Expired key |
| 401 | invalid_api_key | Key not recognised |
| 401 | missing_api_key | No key |
| 401 | paused_api_key | Paused key |
| 401 | revoked_api_key | Revoked key |
| 402 | insufficient_tokens | The call's price is above your token balance: price it first with quote=true Also returns: cost, plan, quote, rate_card, remaining, resets_at, upgrade_url |
| 403 | account_suspended | Suspended account Also returns: dashboard_url, reason |
| 403 | bookmaker_not_in_plan | Venue outside the plan's bookmakers Also returns: valid |
| 403 | bookmaker_not_in_region | Venue outside the region Also returns: type |
| 403 | exchange_history_unavailable | An exchange named on a historical odds route while exchange history is switched off |
| 403 | exchange_not_in_plan | Exchange outside the account's scope Also returns: valid |
| 403 | files_need_whole_scope | Historical odds files on a key or plan narrowed to some sports, bookmakers or markets |
| 403 | market_not_in_plan | Market outside the account's scope Also returns: valid |
| 403 | not_in_key_scope | Product outside the key Also returns: type |
| 403 | origin_not_allowed | Browser key off its website |
| 403 | product_not_in_region | Product the region does not serve Also returns: type |
| 403 | region_not_in_scope | Region outside the key Also returns: type |
| 403 | schema_not_in_scope | Key pinned to another API version Also returns: type |
| 403 | sport_not_in_plan | Sport outside the account's scope Also returns: valid |
| 404 | no_history | A historical odds instant, or the start of an event history's window, before the first recorded board |
| 404 | not_found | No such route |
| 404 | unknown_event | Event not on the raw board |
| 404 | unknown_region | Unknown region |
| 404 | unknown_type | Unknown board |
| 405 | method_not_allowed | A method other than GET |
| 410 | since_expired | The since position can no longer be served: snapshot again with /v2/events/state, then follow from its meta.since Also returns: oldest_since |
| 429 | too_many_downloads | A historical odds file download while too many are already running, for the account or in all |
| 429 | too_many_from_address | The per-address shield |
| 429 | too_many_requests | The account's flood cap |
| 500 | internal_error | Internal error |
| 503 | raw_not_enabled | Raw board not held |
| 503 | temporarily_unavailable | Board or registry not ready |
For help with an error, contact us and include the request_id from the reply.
Versioning
This is API version 2026-07-08, returned in the X-OddsRelay-Api-Version header. Within /v2 we only add things: endpoints, optional fields, enum values and error codes, so ignore fields you don't recognise. A breaking change ships as /v3, announced by email and in the changelog at least 6 months ahead, and /v2 keeps running for at least 12 months after that.
More
Guides
- Example client: A complete client in cURL, Python and JavaScript: quote, call, read the token headers and poll with ETags.
- Regions: The region codes, what each region serves, one region per call, Global bookmakers, and what a prediction market's price means.
- Tokens, quotes and rate limits: How a call is priced, how filters lower the price, and how to handle a 402 or a 429.
- Polling for fewer tokens: Why a wide call rarely gets a free 304, and how filters, ETags and updatedSince cut what each poll costs.
- bet365 odds API: quickstart: bet365 is included in every OddsRelay plan in the UK & Ireland, Free too. One keyed call returns its pre-match prices beside exchange lay prices: the call, its quote and its reply.
- Filtering matched odds: The sports, bookmakers, exchanges and markets filters, the kick-off window, and what a filtered reply leaves out.
- Stable event ids: One id per event, what names an event, which fields stay as first served, ids merged into another, course names and the catch-all sport keys.
- Following each event's state: Whether each event is still on, from two free routes: the snapshot, the log of changes, the recipe for a listing and the windows behind started.
- In-play prices: Events under way with inPlay on raw, one event, standard and dutching: what each value returns, what an in-play price carries and how a call is priced.
- How fresh a price is: The timestamps each reply carries and how to work out a price's age.
- Reading coverage: What /v2/coverage returns with and without a key, and what live and interrupted mean.
- Paging through raw odds: Page through raw odds with a cursor, handle expiry, and fetch only what changed.
- Polling with ETags: Send If-None-Match to get a free 304 when nothing has changed.
- Converting to American odds: Which products return American odds, and a function to convert the rest.
- Historical odds: A past board, one event's price changes, closing lines and day files: the five calls, how they are priced, the archive's window and the errors.
Libraries and tools
Clients, an MCP server and ready-made files for the API. How to install and use each is on Libraries and tools, and what developers build on the feed is on an odds API for developers.
- Python client:
pip install oddsrelay, one method for each live-feed data and lookup route, standard library only - JavaScript and TypeScript client:
npm install oddsrelay, ESM with TypeScript types and no runtime dependencies - R client:
pak::pak("oddsrelay/, one function for each live-feed data and lookup route, replies as lists and data framesoddsrelay-r") - MCP server:
npx -y oddsrelay-mcp, read-only odds tools for AI assistants, with a token cap on every paid call - Google Sheets template: a spreadsheet with
ODDSRELAY_,ODDS ODDSRELAY_andSPORTS ODDSRELAY_formulasBOOKMAKERS - Postman workspace: a public workspace with each live-feed data and lookup route as a request
- OpenAPI contract: the OpenAPI 3.1 file every client above follows, no key needed
Use with an AI assistant
Copy this prompt into your coding assistant and replace the last line with what you want to build. It covers keys, requests, tokens, caching and every error code. Tools that read docs directly can use llms.txt and llms-full.txt.
Show the prompt
You are integrating the OddsRelay odds API (version 2026-07-08). Follow this contract exactly.
BASE URL
https://api.oddsrelay.io (every route is GET; the full contract is https://oddsrelay.io/openapi.json)
KEYS
Send the key as Authorization: Bearer <key> or x-api-key: <key>, never in a query string.
Server keys start or_live_. Read the key from an environment variable; never ship it to a browser.
THE CALL
GET /v2/odds/{type}?region=uk products: standard, 2up, dutching, each-way, extra-place, bog
the whole board in one reply: no paging, meta.next_cursor is always null
GET /v2/odds/raw?region=uk every bookmaker's prices, paged (meta.next_cursor; a cursor expires after 300 s)
GET /v2/historical/... since 17 October 2026 in the UK & Ireland and 16 November 2026 in 20 more regions (bookmakers only): a past board, one event's price changes, a day's closing
lines, the day files (https://oddsrelay.io/docs/guides/historical-odds). They hold
bookmakers and exchanges (bookmakersOnly=true on the board, event and closing
calls: bookmakers alone).
On data routes region is one lowercase code; missing means uk only if uk is your account's home region (the main region
chosen at sign-up) and the key reads it. Any other key gets 400 region_required, which names a code to send.
GET /v2/odds/raw alone takes several international codes in one call (region=us,global; uk is asked alone),
priced as those codes' prices added. Every other route takes one code.
Discovery routes read region too (missing means uk); /v2/regions, /v2/health, /v2/usage, /v2/pricing, /v2/openapi.json take none.
Any parameter a /v2 route doesn't read is 400, and so is one sent twice.
Filters on the matched products, each one comma-separated value (sports=soccer,tennis): sports (<= 20), bookmakers (<= 40), exchanges (<= 4), markets (<= 20),
commenceTimeFrom / commenceTimeTo. Discovery lists the values: GET /v2/sports, /v2/bookmakers.
In play: inPlay=exclude (default) | include | only on raw and /v2/odds/event/{id}; exclude | only on standard
and dutching; 400 on the other products. Under include or only, each event carries in_play. Priced as the
same call without it. Prices only: scores and the match clock are not served. Horse racing is never in play.
(https://oddsrelay.io/docs/guides/in-play)
TOKENS
Every data call costs tokens, priced from the request (product and filters), never the reply's size, except a historical day file, priced per MB.
Add quote=true to any data request to get {cost, remaining, rate_card} for free, before a big call.
Read X-Tokens-Cost on replies to a valid key; X-Tokens-Remaining and X-Tokens-Reset come when the balance is
known, so treat them as optional.
402 insufficient_tokens means the price is above the balance: narrow the filters or choose a plan. On a paid plan,
waiting for resets_at also works; on the free plan's window, resets_at is its end and no tokens follow it.
upgrade_url is absent on a custom plan.
DELIVERY
Accept gzip and check Content-Encoding: standard, dutching, raw and /v2/historical/odds/raw answer a request that refuses gzip
(Accept-Encoding: identity) with 400. Status, health, usage, quotes and errors are always plain.
Store each ETag exactly as sent (quotes included) and send it back as If-None-Match: 304 means unchanged,
no body, no tokens. Quotes carry no ETag.
Rate limits are per account (X-RateLimit-*). On 429 honour Retry-After; our edge's own 429 and 502
have an empty body.
RESPONSE SHAPE (matched products)
{ "meta": { "feed_type", "region", "odds_format", "processed_at", "last_seen", "count",
"version", "next_cursor" (always null) },
"data": [ { "event_id", "sport_key", "sport_title", "competition_key", "previous_ids", "commence_time",
"home_team", "away_team", "event_name" (optional), "venue" (optional),
"markets": [ { "key", "outcomes": [ { "name", "back": [...], "lay": [...] } ] } ] } ] }
lay is an array on standard, 2up and bog; an object {win: [...], place: [...]} on each-way and
extra-place; absent on dutching, where back legs carry dutch_id (group by it; a dutch rates 100 / sum(1/price)).
Event ids are opaque, one per fixture, the same on every route, and never change once served. An id merged
into another is in that event's previous_ids (every live route, matched boards included) and answers on
/v2/odds/event/{id} and in eventIds while that event is on the board, and again if its fixture is listed again within 60 days. An event names itself
with home_team/away_team, venue (a race's course) or event_name (any other teamless event); sport_key,
sport_title and competition_key keep their first served values, and only commence_time moves.
(https://oddsrelay.io/docs/guides/event-ids) Every level can be empty; walk it defensively.
FOLLOWING RAW
Walk again with updatedSince set 15 s before your previous walk began, and dedupe by event id. The first
page's meta.removed lists the events, bookmakers and markets that left the board: apply it, then upsert data.
If meta.removed_since is later than your updatedSince, walk once without it.
An event whose own details changed comes whole. If meta.processed_at stood still for 30 s or more between
two walks, also walk once without updatedSince.
(https://oddsrelay.io/docs/guides/walking-raw#following-changes)
ERRORS
Every JSON error is { "error": { "code", "message", "request_id" } }, plus the extra fields listed.
400 bad_request, date_out_of_range (earliest, latest), missing_param, region_required, unknown_bookmaker (valid), unknown_exchange (valid), unknown_market (products, valid), unknown_sport (valid)
-> fix the request; do not retry.
401 expired_api_key, invalid_api_key, missing_api_key, paused_api_key, revoked_api_key
-> stop and surface it; do not retry.
402 insufficient_tokens (cost, plan, quote, rate_card, remaining, resets_at, upgrade_url)
-> out of tokens: add filters, choose a plan, or on a paid plan wait for X-Tokens-Reset; price a call first with quote=true.
403 account_suspended (dashboard_url, reason), bookmaker_not_in_plan (valid), bookmaker_not_in_region (type), exchange_history_unavailable, exchange_not_in_plan (valid), files_need_whole_scope, market_not_in_plan (valid), not_in_key_scope (type), origin_not_allowed, product_not_in_region (type), region_not_in_scope (type), schema_not_in_scope (type), sport_not_in_plan (valid)
-> refused for this account, key, region or plan; do not retry.
404 no_history, not_found, unknown_event, unknown_region, unknown_type
-> a bad path or value.
405 method_not_allowed
-> use GET.
410 since_expired (oldest_since)
-> see the reference.
429 too_many_downloads, too_many_from_address, too_many_requests
-> back off and honour Retry-After.
500 internal_error
-> transient; retry with backoff.
503 temporarily_unavailable
-> transient; retry with backoff, honouring Retry-After.
400 sport_not_served_by_this_worker
-> a fault on our side, not your request: send the same request again.
503 raw_not_enabled
-> raw odds are not served here: stop and report it; do not retry.
Branch on code, never on message. Log request_id.
WHAT TO BUILD
[Describe what you want here.]
Widgets
The oddsmatcher widget shows live odds on your own site with one script tag. Live odds need a browser key (or_pub_), available on the Enterprise plan; the calculators need no key. See Widgets.
Reference and contract
- API reference: every endpoint, parameter and response
- OpenAPI 3.1 contract: for Postman, Insomnia or a code generator
- Postman collection