OpenOddsAPI API Get started

Endpoints

List Events

Scheduled events for a sport, without prices.

GET/v1/sports/{sport_key}/eventsAPI key

The same events as the odds endpoint with the prices stripped out — cheaper when you only need the schedule.

Path parameters

NameTypeRequiredDescription
sport_keystringrequiredOne of ufc, boxing, tennis, nfl, golf.
Response
JSON
{
  "sport": "ufc",
  "title": "UFC",
  "generated_at": "2026-08-09T23:21:38.425Z",
  "event_count": 29,
  "events": [
    {
      "id": "ufc_2026-08-15_0",
      "sport_key": "ufc",
      "commence_time": "2026-08-15T21:30:00.000Z",
      "home": "Jeremiah Wells",
      "away": "Myktybek Orolbai",
      "books_pricing": 8
    },
    {
      "id": "ufc_2026-08-15_1",
      "sport_key": "ufc",
      "commence_time": "2026-08-15T21:50:00.000Z",
      "home": "Neil Magny",
      "away": "Ramiz Brahimaj",
      "books_pricing": 8
    }
  ]
}

books_pricing tells you how many sources currently have a price on that event, which is a good proxy for how liquid it is.

OpenOddsAPI API — Documentation v1Examples use illustrative data