Working with Picks

Picks are the core output of the scoring engine. Each pick represents a player prop evaluation (e.g., “LeBron James Over 25.5 Points”) scored across 7 independent blocks.

Fetching today’s picks

curl -H "X-API-Key: $NBAV3_DATA_TOKEN" \
  https://nbaproplab.com/api/v1/data/picks/today

This returns all scored picks for today, sorted by score descending.

Filtering picks

The /picks endpoint accepts query parameters for date selection, sorting, sparse fields, and pagination:

# Picks for a specific date, sorted by score descending
curl -H "X-API-Key: $TOKEN" \
  "https://nbaproplab.com/api/v1/data/picks?date=2026-05-20&sort=-score"

# Only essential fields for a lighter payload
curl -H "X-API-Key: $TOKEN" \
  "https://nbaproplab.com/api/v1/data/picks?date=2026-05-20&fields=id,playerName,statType,line,score,rating"

# Paginate through results
curl -H "X-API-Key: $TOKEN" \
  "https://nbaproplab.com/api/v1/data/picks?date=2026-05-20&limit=50&cursor=eyJpZCI6MTIzNDV9"

Available parameters

Parameter	Type	Example
`date`	date	`2026-05-20`
`sort`	field	`score`, `-score`, `date`, `createdAt`, `playerName`, `statType`, `rating`
`fields`	comma-separated	`id,playerName,statType,line,score,rating`
`include`	comma-separated	`player,game,blocks,odds`
`limit`	integer	`50` (default)
`cursor`	string	Pagination cursor from previous response

Sparse fields

For large result sets, request only the fields you need:

curl -H "X-API-Key: $TOKEN" \
  "https://nbaproplab.com/api/v1/data/picks?fields=id,playerName,statType,line,score,rating"

Available fields: id, date, playerName, statType, line, direction, score, rating, period, playerId, gameId, createdAt, blockScoresJson, spiderDataJson.

Understanding the response

Spider chart data

Each pick includes spiderData — the individual block scores that make up the spider (radar) chart:

{
  "score": 72.4,
  "confidence": 0.81,
  "spiderData": {
    "PlayerProfile": 78,
    "Matchup": 65,
    "Synergy": 70,
    "GameContext": 80,
    "MarketLine": 68,
    "AnalysisQuality": 75,
    "ExternalSignals": 60
  }
}

Includes

Use include to embed related data:

# Get pick with full block details, player info, and game context
curl -H "X-API-Key: $TOKEN" \
  "https://nbaproplab.com/api/v1/data/picks/12345?include=blocks,player,game,odds"

Include	Returns
`player`	Player name, team, position
`game`	Matchup, tipoff time, spread, total
`blocks`	Detailed 7-block scores with sub-metrics
`odds`	Line snapshots from each sportsbook

Settled picks

After games complete, picks are settled as hit, miss, push, or void:

# Get settled picks from last week
curl -H "X-API-Key: $TOKEN" \
  "https://nbaproplab.com/api/v1/data/picks/settled?from=2026-05-14&to=2026-05-20"

Pagination

Large result sets use cursor-based pagination:

{
  "data": [...],
  "nextCursor": "eyJpZCI6MTIzNDV9",
  "hasMore": true
}

Pass cursor to get the next page:

curl -H "X-API-Key: $TOKEN" \
  "https://nbaproplab.com/api/v1/data/picks?cursor=eyJpZCI6MTIzNDV9"