Player Props

Get player proposition bets and special betting markets

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 proposition bets (props) for basketball games, including points, rebounds, assists, and combined stat lines.

Query Parameters

gameId · integer · required

Game ID

athleteId · integer

Filter by specific player ID

Code Examples

cURL

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

Response Structure

propositions · array

Array of player props

Show Proposition Object

athleteId · integer

Player ID

athleteName · string

Player name

team · string

Team name

markets · array

Available prop markets

Show Market

type · string

Prop type (points, rebounds, assists, etc.)

line · number

The betting line

over · integer

Odds for over (American format)

under · integer

Odds for under (American format)

Available Prop Types

Type	Description
points	Total points scored
rebounds	Total rebounds
assists	Total assists
threes	Three-pointers made
steals	Total steals
blocks	Total blocks
pts+reb	Points + Rebounds combined
pts+ast	Points + Assists combined
reb+ast	Rebounds + Assists combined
pts+reb+ast	Points + Rebounds + Assists combined
double-double	Yes/No for double-double
triple-double	Yes/No for triple-double

Filter by Player

# Get props for a specific player
curl -X GET "https://v1.basketball.sportsapipro.com/bets/proposition?gameId=12345&athleteId=67890" \
  -H "x-api-key: YOUR_API_KEY"

Use Case: SGP Builder

Combine props for same-game parlays (SGP):

// Build a same-game parlay
const sgpLegs = [];

propositions.forEach(player => {
  const pointsMarket = player.markets.find(m => m.type === 'points');
  if (pointsMarket && pointsMarket.line > 20) {
    sgpLegs.push({
      player: player.athleteName,
      prop: `O${pointsMarket.line} points`,
      odds: pointsMarket.over
    });
  }
});

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