Description

Get the graded result of a bet.

Specific Parameter Information

For a full list of parameters, scroll to the bottom of this page.

sport

The sport of the fixture.

league

The league of the fixture.

fixture_id

The id of the fixture that the bet applies to.

market

The market of the bet you are trying to grade. Make sure to pass the market label not the id.

For example:

Moneyline instead of moneyline
Point Spread instead of point_spread

name

The name of the bet you are trying to grade.

For example:

Buffalo Bills
Over 10.5
Aaron Judge Under 10.5

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_results

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 Responses

Possible `result`

Won: The bet is settled as a win
Lost: The bet is settled as a loss
Refunded: The bet is settled as a push.
Pending: The bet has not yet been confirmed, the reason for this may be because the fixture has not been completed or the results have not been confirmed.
Half Won: Applies for asian markets.
Half Lost: Applies for asian markets.

Response Shape

URL: https://api.opticodds.com/api/v3/grader/odds?sport=mma&league=ufc&fixture_id=B848DE682885&market=Total%20Rounds&name=Under%202.5

{
  "data": {
    "fixture_id": "B848DE682885",
    "away_team_display": "Tracy Cortez",
    "home_team_display": "Rose Namajunas",
    "status": "Completed",
    "away_score": 0,
    "home_score": 1,
    "player_score": null,
    "market": "Total Rounds",
    "name": "Under 2.5",
    "result": "Lost"
  }
}

Error Codes

{"message": "Game not found", "code": 100}
{"message": "Sport not supported", "code": 101}
{"message": "League not supported", "code": 102}
{"message": "Bet type not supported", "code": 103}
{"message": "Game is still live", "code": 104}
{"message": "Tournament not found", "code": 105}
{"message": "Tournament is still live", "code": 106}
{"message": "Game has not started", "code": 107}
{"message": "Game has not completed", "code": 108}
{"message": "Game has been canceled", "code": 109}
{"message": "Score data not found", "code": 201}
{"message": "Incomplete score data", "code": 202}
{"message": "Unsupported bet period", "code": 203}
{"message": "Unsupported spread", "code": 204}
{"message": "Team not in spread", "code": 205}
{"message": "Unsupported over/under", "code": 206}
{"message": "Team not in over/under", "code": 207}
{"message": "Unsupported both teams to score", "code": 208}
{"message": "Unsupported moneyline", "code": 209}
{"message": "Unsupported bet type", "code": 210}
{"message": "Unsupported player name format", "code": 211}
{"message": "Unknown player", "code": 212}
{"message": "Incomplete player data", "code": 213}
{"message": "Unsupported player over/under", "code": 214}
{"message": "Unsupported go the distance", "code": 215}
{"message": "Unsupported total rounds", "code": 216}
{"message": "Tournament leaderboard not found","code": 217}
{"message": "Match ended in retirement", "code": 218}

200success