Proposition Bets

Retrieve player proposition bets (props) including goalscorer markets with first, last, and anytime scorer odds.

GET /bets/proposition

Player Props

cURL

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

200

{
  "propositions": [
    {
      "athleteId": 123,
      "athleteName": "<string>",
      "team": "<string>",
      "markets": [
        {
          "type": "<string>",
          "line": 123,
          "over": 123,
          "under": 123
        }
      ]
    }
  ]
}

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

gameId · integer · required

Unique identifier for the game.

topBookmakerId · integer · default: "14"

Preferred bookmaker ID for odds data.

appTypeId · integer

Application type identifier. Auto-resolved by upstream.

langId · integer

Language identifier. Auto-resolved by upstream.

timezoneName · 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.

userCountryId · integer

User’s country for localization. Auto-resolved by upstream.

Response Structure

propositionBets · array

Array of proposition bet markets.

Show Proposition Bet Object

id · integer

Proposition market identifier.

name · string

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

lineTypeId · integer

Line type identifier for the market category.

sections · array

Market sections grouped by team.

Show Section Object

competitorId · integer

Team identifier for this section.

rows · array

Player rows within this section.

Show Row Object

athleteId · integer

Player identifier.

lineTypeId · integer

Specific line type for this player prop.

secondaryName · string

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

options · array

Betting options for this player.

Show Option Object

num · integer

Option number.

name · string

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

rate · object

Odds in multiple formats.

Show Rate Object

decimal · number

Decimal odds (e.g., 10.0).

fractional · string

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

american · string

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

trend · integer

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

isWon · boolean

Whether this option was successful (concluded markets).

hasRecords · boolean

Whether historical records are available.

bookmakers · array

Bookmaker details including branding and links.

Show Bookmaker Object

id · integer

Bookmaker identifier.

name · string

Bookmaker name.

link · string

Bookmaker website URL.

actionButton · object

CTA button with link and label.

color · string

Brand color (hex).

promotionText · string

Promotional message.

athletes · array

Full athlete information for players in props.

Show Athlete Object

id · integer

Athlete identifier.

name · string

Full player name.

shortName · string

Abbreviated name.

nameForURL · string

URL-friendly name.

sportId · integer

Sport identifier.

clubId · integer

Current club/team ID.

clubName · string

Current club name.

nationalityId · integer

Player’s nationality country ID.

imageVersion · integer

Image version for caching.

lastUpdateId · integer

Current update ID for incremental fetching.

requestedUpdateId · integer

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

ttl · integer

Cache time-to-live in seconds.

sports · array

Sports definitions.

countries · array

Country information.

competitions · array

Competition details.

competitors · array

Team information.

games · 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://v1.football.sportsapipro.com/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://v1.football.sportsapipro.com/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.

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

gameId · integer · required

Game ID

Example:

12345

athleteId · integer

Filter by specific player ID

Response

200 - application/json

Player props retrieved successfully

propositions · object[]

Show child attributes