Reading coverage

One document per region, two views

GET /v2/coverage?region=<code> answers from one document per region, in two views. region missing means uk.

Without a key

Send no Authorization and no x-api-key header. Per product, each bookmaker and sport is live (serving now), or interrupted_24h: not serving now, though it served within the last 24 hours. There are no counts and no times. It is public and cacheable (Cache-Control: public, max-age=60, Access-Control-Allow-Origin: *). This is the route, not the /coverage page on the site, which lists coverage and no statuses.

It also lists, under markets, each product's market keys: every value that product's markets filter takes now, raw's in markets.raw.

curl --compressed -s "https://api.oddsrelay.io/v2/coverage?region=uk"

With a key

Send either key header (an empty or invalid one is a 401, never the public view). You get your key's products that the region serves, bookmakers and exchanges apart, each with the sports it has rows for now, their event counts and last_seen. It is free and counts toward your rate limit.

Depth differs by bookmaker

Bookmakers differ in how many markets they carry for the same event, and the keyless view's markets is each product's whole list, not one bookmaker's. To see the markets one bookmaker carries on an event, call raw with bookmakers set to it and the event's id in eventIds.

From the blog