Skip to main content

Version: 2.0.0

Futures Odds API Documentation

Description

This endpoint returns all current odds for all future markets & bet types across every sports and league: MVP, conference & division winners, seasonal player props & more.

REQUIREMENT

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/future-odds

Parameters

`key` (required)

Your OpticOdds API license key.

`sport`

NOTE

You can pass in multiple of this parameter.

The sport you want to receive odds for. We support the following:

football
basketball
baseball
mma
boxing
hockey
soccer
tennis
golf
motorsports
esports
wrestling
aussie-rules
rugby
lacrosse
cricket
volleyball
politics

`league`

NOTE

You can pass in multiple of this parameter.

The league you want to receive odds for (e.g. NBA)

`sportsbook`

NOTE

You can pass in multiple of this parameter.

The sportsbook(s) you want to receive odds for. We support the following:

`future_name`

NOTE

You can pass in multiple of this parameter.

The future name you want to receive odds for (e.g. Regular Season Wins)

`future_id`

NOTE

You can pass in multiple of this parameter.

The OpticOdds future ID you want to receive odds for (e.g. type:regular_season_wins-sport:basketball-league:nba)

`bet_name`

NOTE

You can pass in multiple of this parameter.

The future bet name you want to receive odds for (e.g. Boston Celtics Under 45.5)

`team_id`

NOTE

You can pass in multiple of this parameter.

The future team_id you want to receive odds for (e.g. EDF03AD3C346)

`player_id`

NOTE

You can pass in multiple of this parameter.

The future player_id you want to receive odds for (e.g. E61E5ECAC811)

`include_team_ids`

Whether or not to include the team_id field on the odds returned, if there is no matching team id, this will default to null.

Example Response

{
    "data": [
        {
            "id": "type:regular_season_wins-sport:basketball-league:nba",
            "name": "Regular Season Wins",
            "sport": "basketball",
            "league": "NBA",
            "odds": [
                {
                    "id": "DBDE0FBA5C0A",
                    "sports_book_name": "bwin",
                    "name": "Boston Celtics Under 45.5",
                    "price": -120.0,
                    "checked_date": "2021-10-29T08:25:09-04:00"
                },
                {
                    "id": "4F401F366083",
                    "sports_book_name": "Borgota",
                    "name": "Atlanta Hawks Under 46.5",
                    "price": -120.0,
                    "checked_date": "2021-10-29T08:25:09-04:00"
                },
                {
                    "id": "EF4E01B7D203",
                    "sports_book_name": "BetMGM",
                    "name": "Atlanta Hawks Over 46.5",
                    "price": 100.0,
                    "checked_date": "2021-10-29T08:25:09-04:00"
                },
                {
                    "id": "73F3AF473567",
                    "sports_book_name": "BetMGM",
                    "name": "Atlanta Hawks Under 46.5",
                    "price": -120.0,
                    "checked_date": "2021-10-29T08:25:09-04:00"
                },
                {
                    "id": "A2EF1FE7942D",
                    "sports_book_name": "Borgota",
                    "name": "Boston Celtics Over 45.5",
                    "price": 100.0,
                    "checked_date": "2021-10-29T08:25:09-04:00"
                },
                {
                    "id": "BB0458A3C031",
                    "sports_book_name": "Borgota",
                    "name": "Atlanta Hawks Over 46.5",
                    "price": 100.0,
                    "checked_date": "2021-10-29T08:25:09-04:00"
                },
                ...
            ]
        }
    ]
}

Description
API Endpoint
Parameters
Example Response