Skip to main content
Version: 2.0.0

Bet Result & Grader API Documentation

Description

This endpoint returns all the final & live bet results and grade for every game. Filterable by sport, league, market, players & more.

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/v2/grader

Parameters

key (required)

Your OpticOdds API license key.

sport (required)

The sport you want to receive a graded result for. We support the following:

  • Baseball
  • Basketball
  • Football
  • Hockey
  • Soccer
  • Tennis
  • MMA
  • eSports

league (required)

The league you want to receive a graded result for (e.g. NFL).

game_id (required)

The game ID you want to receive a graded result for (e.g. 16341-13602-2022-01-23)

market_name (required)

The market name you want to receive a graded result for (e.g. Moneyline)

bet_name (required)

The bet name you want to receive a graded result for (e.g. Buffalo Bills). This is equivalent to the name field returned from the game-odds endpoint.

player_id

Sometimes due the the various naming conventions of sportsbooks, player names are not uniform. Passing a player_id will use the corresponding player if there are issues resolving the bet_name.

show_live_result

Sometimes, some results can be graded before the game is completed. Passing this parameter will tell you the live result at the time the endpoint is called. Use with caution as the default behavior for this endpoint is to wait until the game is completed before returning any results from this endpoint (to account for in game stat corrections or any other stat related issues).

Example Response

{
"data": {
"gameUID": "33152-30886-2022-02-17",
"awayTeam": "Washington Wizards",
"homeTeam": "Brooklyn Nets",
"gameStatus": "Completed",
"awayScore": 117,
"homeScore": 103,
"playerScore": null,
"betType": "Total Points",
"betName": "Under 215.5",
"betResult": "Lost"
}
}

betResult

Potential Values: Won, Lost, Refunded, Pending