Outrights Betting

Retrieve outright/futures betting odds for competitions related to a competitor, including league winner, relegation, and tournament winner markets

GET /bets/outrights

Outright Bets

cURL

curl --request GET \
  --url https://v1.football.sportsapipro.com/bets/outrights \
  --header 'x-api-key: <api-key>'

Overview

Returns outright (futures) betting odds for various markets across competitions. This includes season-long bets such as competition winner, relegation odds, and tournament winners. Data is organized by competition with multiple betting tables per competition.

Query Parameters

competitions · string · required

Comma-separated list of competition IDs to retrieve outrights for.

topBookmaker · integer · default: "14"

The preferred bookmaker ID for odds display.

appTypeId · integer

Application type identifier (resolved automatically).

langId · integer

Language identifier (resolved automatically).

timezoneName · string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York). All date/time fields use ISO 8601 format with a dynamic timezone offset.

userCountryId · integer

Country identifier for localization (resolved automatically).

Response Structure

data · array

Array of outright betting sections grouped by season/competition.

Show Outright Section Object

title · string

Section title (e.g., “Outrights - 2025/2026”).

tables · array

Array of betting tables within this section.

Show Table Object

id · integer

Table identifier.

name · string

Market name (e.g., “Competition Winner”, “To Be Relegated”).

betLineType · integer

Bet line type identifier:

• 64 - Competition Winner
• 66 - To Be Relegated

entityType · integer

Entity type (4 = team/competitor).

columns · array

Column definitions for the table.

Show Column Object

id · integer

Column identifier.

name · string

Column name (e.g., “Rank”, “Odds”).

type · string

Column data type: "Text" or "Rates".

rows · array

Betting options/selections.

Show Row Object

name · string

Team/competitor name.

secondaryName · string

Secondary identifier (e.g., country for international competitions).

entityId · integer

Competitor/team ID.

imageVersion · integer

Image version for team logo.

columnValues · array

Values for each column.

Show Column Value Object

id · integer

Column ID this value belongs to.

value · object

The actual value.

type · integer

Value type: 0 = text, 1 = odds.

value · string

Text value (for type 0).

odds · object

Odds data (for type 1).

Show Odds Object

rate · object

Current odds rates.

decimal · number

Decimal odds format (e.g., 2.62).

fractional · string

Fractional odds format (e.g., “13/8”).

american · string

American odds format (e.g., “+162”).

oldRate · object

Previous odds rates (same structure as rate).

trend · integer

Odds movement trend:

• 0 - No change
• 1 - Shortened (odds decreased, more likely)
• 3 - Drifted (odds increased, less likely)

isWon · boolean

Whether this selection has already won (for concluded markets).

detailsRequest · object

Information for fetching detailed odds.

lineId · integer

Betting line identifier.

publisherId · integer

Publisher/bookmaker ID.

campaign · string

Campaign identifier.

bookmakerId · integer

Bookmaker ID providing these odds.

competitionId · integer

Competition ID this table relates to.

topBookmakerId · integer

The primary bookmaker for this section.

bookmakers · array

Array of bookmaker definitions with branding and links.

sports · array

Array of sport definitions.

countries · array

Array of country definitions.

competitions · array

Array of competition definitions with full metadata.

competitors · array

Array of competitor/team definitions referenced in the outrights.

Bet Line Types

Type ID	Name	Description
64	Competition Winner	Odds to win the competition/league
66	To Be Relegated	Odds for the team to be relegated

Odds Trend Values

Value	Meaning	Description
0	Unchanged	Odds have not moved
1	Shortened	Odds decreased (selection more likely)
3	Drifted	Odds increased (selection less likely)

Example Request

curl -X GET "https://v1.football.sportsapipro.com/bets/outrights?competitions=7,572&topBookmaker=14" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "title": "Outrights - 2025/2026",
      "tables": [
        {
          "id": 1,
          "name": "Competition Winner",
          "betLineType": 64,
          "entityType": 4,
          "columns": [
            { "id": 1, "name": "Rank", "type": "Text" },
            { "id": 2, "name": "Odds", "type": "Rates" }
          ],
          "rows": [
            {
              "name": "Arsenal",
              "entityId": 104,
              "imageVersion": 0,
              "columnValues": [
                {
                  "id": 1,
                  "value": { "value": "1", "type": 0 }
                },
                {
                  "id": 2,
                  "value": {
                    "odds": {
                      "rate": {
                        "decimal": 1.67,
                        "fractional": "2/3",
                        "american": "-149"
                      },
                      "oldRate": {
                        "decimal": 2.8,
                        "fractional": "9/5",
                        "american": "+180"
                      },
                      "trend": 1
                    },
                    "type": 1
                  }
                }
              ],
              "detailsRequest": {
                "lineId": 977836,
                "publisherId": 147,
                "campaign": ""
              }
            },
            {
              "name": "Manchester City",
              "entityId": 110,
              "imageVersion": 0,
              "columnValues": [
                {
                  "id": 1,
                  "value": { "value": "2", "type": 0 }
                },
                {
                  "id": 2,
                  "value": {
                    "odds": {
                      "rate": {
                        "decimal": 2.62,
                        "fractional": "13/8",
                        "american": "+162"
                      },
                      "trend": 1
                    },
                    "type": 1
                  }
                }
              ]
            }
          ],
          "bookmakerId": 14,
          "competitionId": 7
        },
        {
          "id": 3,
          "name": "To Be Relegated",
          "betLineType": 66,
          "entityType": 4,
          "columns": [
            { "id": 1, "name": "Rank", "type": "Text" },
            { "id": 2, "name": "Odds", "type": "Rates" }
          ],
          "rows": [
            {
              "name": "Wolves",
              "entityId": 15,
              "columnValues": [
                {
                  "id": 1,
                  "value": { "value": "20", "type": 0 }
                },
                {
                  "id": 2,
                  "value": {
                    "odds": {
                      "rate": {
                        "decimal": 1.01,
                        "fractional": "1/100",
                        "american": "-10000"
                      },
                      "trend": 1
                    },
                    "type": 1
                  }
                }
              ]
            }
          ],
          "bookmakerId": 14,
          "competitionId": 7
        }
      ],
      "topBookmakerId": 14
    }
  ],
  "bookmakers": [...],
  "sports": [...],
  "competitions": [...],
  "competitors": [...]
}

Use Cases

• Season Predictions: Display odds for league winners before and during the season
• Relegation Battles: Show which teams are favorites to be relegated
• Tournament Winners: Display Champions League, FA Cup, and other tournament winner odds
• Odds Comparison: Track odds movements with trend indicators
• Multiple Competitions: Retrieve outrights for related competitions in one call

Notes

• Odds are provided by the specified bookmaker (default: Bet365)
• The trend field indicates recent odds movement direction
• Rows are typically ordered by current odds (favorites first)
• The isWon field appears for concluded markets
• International competitions may include secondaryName for country identification

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

competitionId · integer · required

Competition identifier

Example:

7

Response

200

Outright bets retrieved successfully