Proposition Bets (Retired)

This endpoint is retired. GET /v1/{sport}/bets/proposition now returns {"success": false, "error": "Endpoint not available on V1"} following the V1 VPS migration. V1 supports: live, all, current, competitions, countries, news, game/:id, competition/:id/[standings|results|games|stats|brackets|transfers|news], competitor/:id/[games|results], h2h/:id1/:id2. Player-level data and predictions are not part of V1.There is no player-prop replacement today: match:{id}:odds on V2 relays bet365 main and side markets without player markets, V4 carries no player market groups. The reference below is kept for historical clients only.

Overview

Returns player-specific betting markets for a game, including goalscorer propositions. Markets are organized by team with individual player odds for first scorer, last scorer, and anytime scorer.

Query Parameters

integer

required

Unique identifier for the game.

integer

default:"14"

Preferred bookmaker ID for odds data.

integer

Application type identifier. Auto-resolved.

integer

Language identifier. Auto-resolved.

string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York).

All startTime fields in game data use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.

integer

User’s country for localization. Auto-resolved.

Response Structure

array

Array of proposition bet markets.

Show Proposition Bet Object

integer

Proposition market identifier.

string

Market name (e.g., “To Score”).

integer

Line type identifier for the market category.

array

Market sections grouped by team.

Show Section Object

integer

Team identifier for this section.

array

Player rows within this section.

Show Row Object

integer

Player identifier.

integer

Specific line type for this player prop.

string

Player info (e.g., “#52, Right Forward”).

array

Betting options for this player.

Show Option Object

integer

Option number.

string

Option name (“First”, “Last”, “Anytime”).

object

Odds in multiple formats.

Show Rate Object

number

Decimal odds (e.g., 10.0).

string

Fractional odds (e.g., “9/1”).

string

American odds (e.g., “+900”).

integer

Odds movement (1=up, 2=stable, 3=down).

boolean

Whether this option was successful (concluded markets).

boolean

Whether historical records are available.

array

Bookmaker details including branding and links.

Show Bookmaker Object

integer

Bookmaker identifier.

string

Bookmaker name.

string

Bookmaker website URL.

object

CTA button with link and label.

string

Brand color (hex).

string

Promotional message.

array

Full athlete information for players in props.

Show Athlete Object

integer

Athlete identifier.

string

Full player name.

string

Abbreviated name.

string

URL-friendly name.

integer

Sport identifier.

integer

Current club/team ID.

string

Current club name.

integer

Player’s nationality country ID.

integer

Image version for caching.

integer

Current update ID for incremental fetching.

integer

The update ID that was requested (-1 for latest).

integer

Cache time-to-live in seconds.

array

Sports definitions.

array

Country information.

array

Competition details.

array

Team information.

array

Game details.

Goalscorer Market Types

Option	Description
First	First goalscorer of the match
Last	Last goalscorer of the match
Anytime	Score at any point during the match

Example Request

curl -X GET "https://api.sportsapipro.com/v1/football/bets/proposition?gameId=4609055" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "propositionBets": [
    {
      "id": 1,
      "name": "To Score",
      "lineTypeId": 57,
      "sections": [
        {
          "competitorId": 110,
          "rows": [
            {
              "athleteId": 71578,
              "lineTypeId": 59,
              "secondaryName": "#10, Right Forward",
              "options": [
                {
                  "num": 1,
                  "name": "First",
                  "rate": {
                    "decimal": 10.0,
                    "fractional": "9/1",
                    "american": "+900"
                  },
                  "trend": 2,
                  "isWon": true
                },
                {
                  "num": 1,
                  "name": "Last",
                  "rate": {
                    "decimal": 10.0,
                    "fractional": "9/1",
                    "american": "+900"
                  },
                  "trend": 2,
                  "isWon": false
                },
                {
                  "num": 1,
                  "name": "Anytime",
                  "rate": {
                    "decimal": 3.75,
                    "fractional": "11/4",
                    "american": "+275"
                  },
                  "trend": 2,
                  "isWon": true
                }
              ],
              "hasRecords": false
            }
          ]
        },
        {
          "competitorId": 63,
          "rows": [
            {
              "athleteId": 100680,
              "lineTypeId": 59,
              "secondaryName": "#7, Left Forward",
              "options": [
                {
                  "num": 1,
                  "name": "First",
                  "rate": {
                    "decimal": 13.0,
                    "fractional": "12/1",
                    "american": "+1200"
                  },
                  "trend": 2,
                  "isWon": false
                },
                {
                  "num": 1,
                  "name": "Anytime",
                  "rate": {
                    "decimal": 4.75,
                    "fractional": "7/2",
                    "american": "+375"
                  },
                  "trend": 2,
                  "isWon": false
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "bookmakers": [
    {
      "id": 14,
      "name": "Bet365",
      "link": "https://extra.bet365.com/...",
      "color": "#007B5B",
      "promotionText": "Sign up at bet365 today"
    }
  ],
  "athletes": [
    {
      "id": 71578,
      "name": "Rayan Cherki",
      "shortName": "Cherki",
      "nameForURL": "cherki",
      "clubId": 110,
      "clubName": "Manchester City",
      "nationalityId": 5,
      "imageVersion": 44
    }
  ],
  "lastUpdateId": 5495116431,
  "ttl": 30,
  "sports": [...],
  "countries": [...],
  "competitions": [...],
  "competitors": [...],
  "games": [...]
}

Use Cases

Goalscorer Markets Display

Show player prop markets organized by team with odds for first, last, and anytime scorer.

Player Odds Comparison

Compare odds across players within the same team or across both teams.

Settled Market Analysis

For concluded games, identify winning selections using isWon: true.

Player Images

Use athleteId with the Images API to display player photos alongside odds.

Notes

Markets are organized by team (competitorId) in the sections array
Use the athletes array to get full player details (name, club, nationality)
The secondaryName provides quick player info (shirt number, position)
For concluded matches, isWon indicates successful betting outcomes
Odds are provided in decimal, fractional, and american formats

Troubleshooting

Empty Response

If you receive a response with an empty propositionBets array:

{
  "lastUpdateId": 5546350228,
  "requestedUpdateId": -1,
  "ttl": 30
}

This indicates no proposition markets are available for this game. This is normal and can happen when:

The game hasn’t started yet (props may appear closer to kickoff)
The game has ended (markets are settled and removed)
The league/competition doesn’t support player props
Bookmakers haven’t published props for this specific match

Checking Data Availability

const response = await fetch(
  'https://api.sportsapipro.com/v1/football/bets/proposition?gameId=4609055',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

if (!data.propositionBets || data.propositionBets.length === 0) {
  console.log('No player props available for this game');
  // Handle gracefully - show message or hide props section
} else {
  // Process props normally
}

Coverage Notes

League/Competition	Prop Coverage
Premier League	Good coverage for major matches
La Liga, Serie A, Bundesliga	Good coverage for major matches
Champions League	Strong coverage
Lower/domestic leagues	Limited or no coverage

Props coverage is actively expanding. If a game doesn’t have props now, check back closer to kickoff or try a higher-profile match.

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Proposition Bets (Retired)

Overview

Query Parameters

Response Structure

Goalscorer Market Types

Example Request

Example Response

Use Cases

Goalscorer Markets Display

Player Odds Comparison

Settled Market Analysis

Player Images

Notes

Troubleshooting

Empty Response

Checking Data Availability

Coverage Notes

​Overview

​Query Parameters

​Response Structure

​Goalscorer Market Types

​Example Request

​Example Response

​Use Cases

​Goalscorer Markets Display

​Player Odds Comparison

​Settled Market Analysis

​Player Images

​Notes

​Troubleshooting

​Empty Response

​Checking Data Availability

​Coverage Notes

Overview

Query Parameters

Response Structure

Goalscorer Market Types

Example Request

Example Response

Use Cases

Goalscorer Markets Display

Player Odds Comparison

Settled Market Analysis

Player Images

Notes

Troubleshooting

Empty Response

Checking Data Availability

Coverage Notes