Skip to main content
Version: 1.0.0

Games

REQUIREMENT

You'll need a license key to use OpticOdds' API. You can get one by contacting us at www.opticodds.com.

API Endpoint

https://api.opticodds.com/api/feed/games/

Parameters

NOTE

You can pass in multiple of the same parameters in each GET request. The returned games array is sorted by games with a start date nearest to furthest.

key (required)

Your OpticOdds API license key.

page

The page of the response you want. Note: the page index starts at 1, and each response returns up to 500 games.

sport

The sport you want to receive games for. We support the following:

  • football
  • basketball
  • baseball
  • mma
  • boxing
  • hockey
  • soccer
  • tennis
  • golf
  • motorsports
  • esports

league

The league you want to receive games for (e.g. NCAA)

isLive

Flag to filter for odds for live games (supports values true, yes, t, 1)

startDateBefore

Specify this value if you want to receive all games before a specific date. Please pass in an ISO 8601 date for the best results.

startDateAfter

Specify this value if you want to receive all games after a specific date. Please pass in an ISO 8601 date for the best results.

Example Response

[
{
"id":1687,
"sport":"football",
"league":"NCAA",
"start_date":"2021-08-28T13:00:00-04:00",
"away_team":"Nebraska",
"home_team":"Illinois",
"is_live":false
},
{
"id":1681,
"sport":"football",
"league":"NCAA",
"start_date":"2021-08-28T14:00:00-04:00",
"away_team":"Connecticut",
"home_team":"Fresno State",
"is_live":false
},
{
"id":1724,
"sport":"football",
"league":"NCAA",
"start_date":"2021-08-28T15:30:00-04:00",
"away_team":"Hawaii",
"home_team":"Ucla",
"is_live":false
},
{
"id":1741,
"sport":"football",
"league":"NCAA",
"start_date":"2021-08-28T18:00:00-04:00",
"away_team":"Eastern Illinois",
"home_team":"Indiana State",
"is_live":false
},
{
"id":1743,
"sport":"football",
"league":"NCAA",
"start_date":"2021-08-28T19:00:00-04:00",
"away_team":"Alcorn State",
"home_team":"Nc Central",
"is_live":false
},
{
"id":1739,
"sport":"football",
"league":"NCAA",
"start_date":"2021-08-28T19:00:00-04:00",
"away_team":"Southern Utah",
"home_team":"San Jose State",
"is_live":false
},
...
]