API reference
Every endpoint, parameter, response and error code. If this is your first call, start with the quickstart.
Try a call in the request tool: Standard2UpDutchingEach-wayExtra placeBest odds guaranteedRaw odds
What the API serves
The OddsRelay API serves odds as JSON from 140+ bookmakers, 60+ of them live in the UK & Ireland: each bookmaker’s raw prices, and matched boards that pair every back price with an exchange lay from Betfair, Smarkets and Matchbook and the money available at it, and the bookmakers' and exchanges' price history since 17 October 2026. Every route is a GET to https://api.oddsrelay.io, with your API key in a header.
- Odds: the matched boards, the raw board and one event, with standard, dutching and raw in play too. /v2/odds/{type}, /v2/odds/raw, /v2/odds/event/{id}
- Discovery: the sports, competitions, events, venues and regions you can ask for, free. /v2/sports, /v2/events, /v2/bookmakers, /v2/regions
- Account: your plan, balance and scope, and the price table, free. /v2/usage, /v2/pricing
- Service: coverage, product status, board freshness, liveness and the contract itself. /v2/coverage, /v2/status, /v2/spotlight, /v2/health, /v2/openapi.json, /healthz
- Historical: the board at a past instant, one event's price changes, closing lines and the day files. /v2/historical/odds/raw, /v2/historical/events/{id}/odds, /v2/historical/closing, /v2/historical/files, /v2/historical/files/{tier}/{sport}/{file}
The reference below is drawn from the OpenAPI 3.1 file at https://api.oddsrelay.io/v2/openapi.json, which needs no key. The endpoints, error codes and developer guides are also one text file: llms-full.txt.