Skip to main content
GET
/
bets
/
proposition
Player Props
curl --request GET \
  --url https://v1.basketball.sportsapipro.com/bets/proposition \
  --header 'x-api-key: <api-key>'
{
  "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 -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

Available Prop Types

TypeDescription
pointsTotal points scored
reboundsTotal rebounds
assistsTotal assists
threesThree-pointers made
stealsTotal steals
blocksTotal blocks
pts+rebPoints + Rebounds combined
pts+astPoints + Assists combined
reb+astRebounds + Assists combined
pts+reb+astPoints + Rebounds + Assists combined
double-doubleYes/No for double-double
triple-doubleYes/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[]