Description

Get the graded result of a future.

Currently this only supports golf.

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.

tournament_id

The id of the fixture that the bet applies to.

market

The market of the bet you are trying to grade.

For example:

BMW Championship 2024 Winner
BMW Championship 2024 Top 5 Finish

name

The name of the bet you are trying to grade.

For example:

Tiger Woods

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.

Dead Heat Reduction

The value can be null if there is no reduction and its value is the highlighted value in the picture below:

More information can be found here.

Response Shape

URL: https://api.opticodds.com/api/v3/grader/futures?sport=golf&league=PGA&tournament_id=0D9C9CCC70BF&market=BMW%20Championship%202024%20Winner&name=Aaron%20Rai

{
  "data": {
    "tournament_id": "0D9C9CCC70BF",
    "tournament_name": "BMW Championship 2024",
    "status": "Completed",
    "market": "BMW Championship 2024 Winner",
    "name": "Aaron Rai",
    "result": "Lost",
    "dead_heat_reduction": null
  }
}

Response with Dead Heat

URL: https://api.opticodds.com/api/v3/grader/futures?sport=golf&league=PGA&tournament_id=0D9C9CCC70BF&market=BMW%20Championship%202024%20Top%205%20Finish&name=Tommy%20Fleetwood

{
  "data": {
    "tournament_id": "0D9C9CCC70BF",
    "tournament_name": "BMW Championship 2024",
    "status": "Completed",
    "market": "BMW Championship 2024 Top 5 Finish",
    "name": "Tommy Fleetwood",
    "result": "Won",
    "dead_heat_reduction": 4
  }
}

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