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.
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
- Cricket
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