---
updatedAt: 2026-06-04T22:07:08.000Z
agentTools:
  projectIndex: https://developer.opticodds.com/llms.txt
---

# /grader/futures

## 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:

<Image align="center" src="https://files.readme.io/e13aaae3bd301e9ebfca1591197cbac7a64bbe34574e73182f43ab0e094dcabb-Screenshot_2024-06-07_at_12.57.27.png" />

More information can be found [here](https://help.draftkings.com/hc/en-us/articles/4405230597139-What-is-a-Dead-Heat-Reduction-US#h_01HNDQ8GYXQFA5V4R2P7FR0YZT).

#### 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`

```json json
{
  "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`

```json
{
  "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}`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "OpticOdds",
    "description": "OpticOdds API",
    "version": "3.0.0"
  },
  "servers": [
    {
      "url": "https://api.opticodds.com/api/v3",
      "description": "Production server"
    }
  ],
  "paths": {
    "/grader/futures": {
      "get": {
        "tags": [
          "Grader"
        ],
        "parameters": [
          {
            "required": true,
            "deprecated": false,
            "explode": true,
            "schema": {
              "title": "sport",
              "type": "string"
            },
            "name": "sport",
            "in": "query",
            "allowEmptyValue": false,
            "allowReserved": false
          },
          {
            "required": true,
            "deprecated": false,
            "explode": true,
            "schema": {
              "title": "league",
              "type": "string"
            },
            "name": "league",
            "in": "query",
            "allowEmptyValue": false,
            "allowReserved": false
          },
          {
            "required": true,
            "deprecated": false,
            "explode": true,
            "schema": {
              "title": "tournament_id",
              "type": "string"
            },
            "name": "tournament_id",
            "in": "query",
            "allowEmptyValue": false,
            "allowReserved": false
          },
          {
            "required": true,
            "deprecated": false,
            "explode": true,
            "schema": {
              "title": "market",
              "type": "string"
            },
            "name": "market",
            "in": "query",
            "allowEmptyValue": false,
            "allowReserved": false
          },
          {
            "required": true,
            "deprecated": false,
            "explode": true,
            "schema": {
              "title": "name",
              "type": "string"
            },
            "name": "name",
            "in": "query",
            "allowEmptyValue": false,
            "allowReserved": false
          },
          {
            "required": false,
            "deprecated": false,
            "explode": true,
            "schema": {
              "title": "player_id",
              "type": "string"
            },
            "name": "player_id",
            "in": "query",
            "allowEmptyValue": false,
            "allowReserved": false
          },
          {
            "required": false,
            "deprecated": false,
            "explode": true,
            "schema": {
              "title": "show_live_result",
              "type": "string"
            },
            "name": "show_live_result",
            "in": "query",
            "allowEmptyValue": false,
            "allowReserved": false
          }
        ],
        "responses": {
          "200": {
            "description": "success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FutureGraderExternalResponse"
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {
      "FutureGrader": {
        "title": "FutureGrader",
        "required": [
          "tournament_id",
          "tournament_name",
          "status",
          "market",
          "name",
          "result"
        ],
        "type": "object",
        "properties": {
          "tournament_id": {
            "title": "Tournament Id",
            "type": "string"
          },
          "tournament_name": {
            "title": "Tournament Name",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "market": {
            "title": "Market",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "result": {
            "title": "Result",
            "type": "string"
          },
          "dead_heat_reduction": {
            "title": "Dead Heat Reduction",
            "type": "number",
            "nullable": true
          }
        }
      },
      "FutureGraderExternalResponse": {
        "title": "FutureGraderExternalResponse",
        "required": [
          "data"
        ],
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/FutureGrader"
          }
        }
      }
    },
    "securitySchemes": {
      "Header": {
        "type": "apiKey",
        "name": "X-Api-Key",
        "in": "header"
      },
      "QueryParam": {
        "type": "apiKey",
        "name": "key",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "Header": []
    },
    {
      "QueryParam": []
    }
  ]
}
```