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
        }
      ]
    }
  ]
}

V1 Legacy Endpoint — This is a V1 API endpoint. For new integrations, we recommend using the Basketball V2 API which provides richer data and more endpoints.

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