DocsGuides
Guides
Short guides to specific parts of the API. For every endpoint and parameter, see the API reference.
Getting started
- Example clientA complete client in cURL, Python and JavaScript: quote, call, read the token headers and poll with ETags.
- Tokens, quotes and rate limitsHow a call is priced, how filters lower the price, and how to handle a 402 or a 429.
- Polling for fewer tokensWhy a wide call rarely gets a free 304, and how filters, ETags and updatedSince cut what each poll costs.
- bet365 odds API: quickstartbet365 is included in every OddsRelay plan, Free too. One keyed call returns its pre-match prices beside exchange lay prices: the call, its quote and its reply.
Working with the data
- Filtering matched oddsThe sports, bookmakers, exchanges and markets filters, the kick-off window, and what a filtered reply leaves out.
- In-play pricesEvents 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 isThe timestamps each reply carries and how to work out a price's age.
- Reading coverageWhat /v2/coverage returns with and without a key, and what live and interrupted mean.
- Paging through raw oddsPage through raw odds with a cursor, handle expiry, and fetch only what changed.
- Polling with ETagsSend If-None-Match to get a free 304 when nothing has changed.
- Converting to American oddsWhich products return American odds, and a function to convert the rest.
- Historical oddsA 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.