Polling with ETags
Send If-None-Match to get a free 304 when nothing has changed.
The label
Data replies, /v2/sports, /v2/events and /v2/bookmakers carry an ETag: a label of the decompressed content, with -gz inside the quotes on the gzip copy. It changes when, and only when, those bytes change. /v2/pricing and /v2/openapi.json carry the body's SHA-256 instead.
The 304
Send the ETag back as If-None-Match. If the body would be the same, the reply is 304 Not Modified. It has an empty body and costs nothing, and it still counts toward your rate limit. Keep the rows you have. A call the balance can't cover is refused 402 even with If-None-Match.
Pacing
Keyed replies carry Cache-Control: private, max-age=2, must-revalidate, except a historical odds day file, which carries private, max-age=86400, immutable. Poll as often as your product needs: an unchanged reply costs you only a free 304.
A wide call is rarely unchanged: Polling for fewer tokens says why, and what to narrow.
From the blog
- The anatomy of an odds API responseEvery field in a /v2 odds response, from the meta envelope down to each back and lay offer.
- How odds feeds handle suspended and void marketsHow feeds mark a suspended or void market, and what your code should do when a price disappears.
- How to store and version odds dataKeep your own odds history: an append-only table, the feed's timestamps and fixture keys you own.
Every parameter: API reference.