Endpoints

List Bookmakers

GET/v1/booksAPI key

Returns every bookmaker covered by the API, with the regions they are offered in.

Request

cURL

curl https://api.openoddsapi.com/v1/books \
  -H "X-API-Key: sk_test_your_key_here"

JavaScript

const res = await fetch("https://api.openoddsapi.com/v1/books", {
  headers: { "X-API-Key": "sk_test_your_key_here" }
});
const books = await res.json();
console.log(books);

Python

import requests

res = requests.get(
    "https://api.openoddsapi.com/v1/books",
    headers={"X-API-Key": "sk_test_your_key_here"},
)
print(res.json())

200 OK — array of bookmaker objects

JSON

[
  { "key": "draftkings", "title": "DraftKings", "regions": ["us"] },
  { "key": "fanduel", "title": "FanDuel", "regions": ["us"] },
  { "key": "betmgm", "title": "BetMGM", "regions": ["us", "uk"] },
  { "key": "caesars", "title": "Caesars", "regions": ["us"] },
  { "key": "bet365", "title": "bet365", "regions": ["us", "uk", "eu"] },
  { "key": "pinnacle", "title": "Pinnacle", "regions": ["uk", "eu", "au"] },
  { "key": "williamhill", "title": "William Hill", "regions": ["uk", "eu"] },
  { "key": "betfair", "title": "Betfair", "regions": ["uk", "eu"] }
]

Not every bookmaker carries every sport. Availability varies by region and market; a bookmaker missing from an odds response simply has no current prices for that filter.