Introduction
The NBA Prop Lab API provides programmatic access to a comprehensive NBA player props scoring engine. Every pick is evaluated by 7 independent scoring blocks, each producing a 0–100 score with a confidence index. A weighted orchestrator combines them into a final score that determines pick quality.
Who is this for?
Section titled “Who is this for?”The Data API is available to Sharp-tier subscribers and admins. It’s designed for:
- Sports analytics developers building custom dashboards or models
- Data scientists running backtests and research notebooks
- Automated betting workflows that consume picks programmatically
- Content creators building pick-tracking tools or newsletters
Core concepts
Section titled “Core concepts”Scoring blocks
Section titled “Scoring blocks”Each pick is evaluated across 7 dimensions:
| Block | Weight | Evaluates |
|---|---|---|
| Player Profile | 25% | Season averages, trends, consistency, fatigue |
| Matchup | 20% | Opponent defense, pace, DvP, H2H history |
| Synergy | 10% | Teammate injuries, on/off splits, usage shifts |
| Game Context | 15% | Spread, total, home/away, B2B, referee factors |
| Market Line | 15% | Edge vs line, movement, consensus, EV |
| Analysis Quality | 10% | Sample size, hit rate, confidence intervals |
| External Signals | 5% | Projections, insider leads |
Pick ratings
Section titled “Pick ratings”Picks are classified by final score:
| Rating | Display Name | Score | Typical volume |
|---|---|---|---|
| Good | PREMIUM | ≥ 63 | ~13 picks/day |
| Marginal | STANDARD | ≥ 60 | ~42 picks/day |
| Weak | Internal only | ≥ 54 | Not published |
| Avoid | Internal only | < 54 | Not published |
Authentication methods
Section titled “Authentication methods”The API supports three authentication methods:
- JWT Bearer token — for authenticated users via login
- API Key (
X-API-Keyheader) — for programmatic access by Sharp subscribers - Ops Token (
Authorization: Bearer nbav3_ops_...) — for operations/admin automation
See the Authentication guide for details.
Base URL
Section titled “Base URL”https://nbaproplab.com/api/v1/dataAll Data API endpoints are prefixed with /api/v1/data. Operations endpoints use /api/v1/ops.
Next steps
Section titled “Next steps”- Quickstart — make your first API call in 2 minutes
- Authentication — set up API keys
- Working with Picks — query, filter, and understand pick data