Quickstart

Prerequisites

• A Sharp-tier subscription on nbaproplab.com
• An API key (created in your account settings)

Your first request

1. Create an API key

   Log in to nbaproplab.com/account, go to API Keys, and create a new key. Copy the raw key — it’s only shown once.

2. Fetch today’s picks

   curl

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

   TypeScript

   const res = await fetch('https://nbaproplab.com/api/v1/data/picks/today', {
     headers: { 'X-API-Key': process.env.NBAV3_DATA_TOKEN },
   });
   const picks = await res.json();
   console.log(picks);

   Python

   import requests, os
   
   resp = requests.get(
       "https://nbaproplab.com/api/v1/data/picks/today",
       headers={"X-API-Key": os.environ["NBAV3_DATA_TOKEN"]},
   )
   print(resp.json())

3. Explore the response

   The response contains today’s scored picks with spider chart data:

   [
     {
       "id": 12345,
       "playerName": "LeBron James",
       "statType": "Points",
       "line": 25.5,
       "direction": "Over",
       "score": 72.4,
       "rating": "Good",
       "confidence": 0.81,
       "spiderData": {
         "PlayerProfile": 78,
         "Matchup": 65,
         "Synergy": 70,
         "GameContext": 80,
         "MarketLine": 68,
         "AnalysisQuality": 75,
         "ExternalSignals": 60
       }
     }
   ]

Common next steps

Goal	Endpoint	Guide
Get picks for a specific date	GET /picks?date=2026-05-20	Working with Picks
Check your API usage	GET /usage	Rate Limits
Set up real-time alerts	POST /webhook-subscriptions	Webhooks
Export historical data	POST /exports	Bulk Exports

Environment variables

We recommend storing your credentials as environment variables:

export NBAV3_DATA_TOKEN="your_api_key_here"
export NBAV3_API_BASE_URL="https://nbaproplab.com"  # optional, this is the default