Skip to main content
Version: 2.0.0

Future Grader

REQUIREMENT

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

NOTE

This endpoint is in beta, so please verify and let us know if there are any issues. We currently only support golf.

API Endpoint​

https://api-external.oddsjam.com/api/v2/future-grader

Parameters​

key (required)​

Your OddsJam API license key.

sport (required)​

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

  • Golf

league (required)​

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

tournament_id or tournament_name (required)​

The tournament ID you want to receive a graded result for (e.g. BCCA6E27E1CC or AT&T Pebble Beach Pro-Am 2024)

future_name (required)​

The future name you want to receive a graded result for (e.g. AT&T Pebble Beach Pro-Am 2024 Top 5 Finish)

bet_name (required)​

The bet name you want to receive a graded result for (e.g. Jason Day). This is equivalent to the name field returned from the future-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": {
        "tournamentUID": "BCCA6E27E1CC",
        "tournamentName": "AT&T Pebble Beach Pro-Am 2024",
        "tournamentStatus": "Completed",
        "betType": "AT&T Pebble Beach Pro-Am 2024 Top 5 Finish",
        "betName": "Jason Day",
        "betResult": "Won",
        "deadHeatReduction": 3
    }
}

betResult​

Potential Values: Won, Lost, Refunded, Pending.