OpenOddsAPI API Get started

Endpoints

List Sports

Every sport we carry, with live book counts and event counts.

GET/v1/sportsAPI key

Returns each sport, whether it is currently active, how many books are pricing it and how many events are available.

Response
JSON
{
  "sports": [
    {
      "key": "ufc",
      "title": "UFC",
      "group": "Mixed Martial Arts",
      "active": true,
      "events": 29,
      "books": 8
    },
    {
      "key": "boxing",
      "title": "Boxing",
      "group": "Boxing",
      "active": true,
      "events": 62,
      "books": 4
    },
    {
      "key": "tennis",
      "title": "Tennis",
      "group": "Tennis",
      "active": true,
      "events": 68,
      "books": 4
    },
    {
      "key": "nfl",
      "title": "NFL",
      "group": "American Football",
      "active": true,
      "events": 82,
      "books": 4
    },
    {
      "key": "golf",
      "title": "Golf",
      "group": "Golf",
      "active": true,
      "events": 13,
      "books": 5
    }
  ]
}

active is false when every source for that sport is stale — treat it as a signal to skip rather than to retry.

OpenOddsAPI API — Documentation v1Examples use illustrative data