API Documentation

Programmatic access to APEX player impact ratings.

Authentication

All API endpoints (except /api/v1/health) require an API key passed via the Authorization header:

curl -H "Authorization: Bearer apex_your-api-key" \
  https://apexhoops.fyi/api/v1/ratings

API keys are issued manually. Contact us for API access.

Rate Limits

Rate limits are enforced per API key on a rolling 1-hour window.

Tier	Requests / Hour
Basic	100
Commercial	1,000

Every response includes rate limit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 2026-03-28T15:00:00.000Z

Endpoints

GET/api/v1/health

Health check. No authentication required.

Response

{
  "status": "ok",
  "last_updated": "2026-03-27",
  "refreshed_at": "2026-03-28T12:00:00Z"
}

GET/api/v1/ratings

Fetch APEX ratings for all players. Returns all bridge metric columns.

Parameter	Type	Default	Description
position	1-3	all	Filter by position (1=G, 2=F, 3=C)
min_minutes	number	0	Minimum minutes played
limit	number	100	Max results (max: 500)

Example

curl -H "Authorization: Bearer apex_your-key" \
  "https://apexhoops.fyi/api/v1/ratings?position=5&min_minutes=5000&limit=10"

Response

{
  "count": 10,
  "data": [
    {
      "player_id": 203999,
      "position": 5,
      "player_name": "Nikola Jokic",
      "minutes": 18432.5,
      "raw_pm_per36": 10.2,
      "leverage_adj": 0.8,
      "age_adj": 1.1,
      "teammate_opp_adj": -0.3,
      "apex_per_36": 11.8,
      "team": "DEN",
      "is_active": true,
      "age": 31,
      "birthdate": "1995-02-19",
      "updated_at": "2026-03-28T12:00:00Z"
    }
  ]
}

GET/api/v1/player/:id

Fetch a single player's current ratings (all positions) and biographical data.

Response

{
  "player": {
    "player_id": 203999,
    "player_name": "Nikola Jokic",
    "height_str": "6-11",
    "weight": 284,
    "birthdate": "1995-02-19"
  },
  "ratings": [
    {
      "position": 5,
      "minutes": 18432.5,
      "raw_pm_per36": 10.2,
      "leverage_adj": 0.8,
      "age_adj": 1.1,
      "teammate_opp_adj": -0.3,
      "apex_per_36": 11.8,
      "team": "DEN",
      "is_active": true
    }
  ]
}

GET/api/v1/player/:id/history

Fetch historical APEX snapshots for a player over time.

Parameter	Type	Description
from	YYYY-MM-DD	Start date (inclusive)
to	YYYY-MM-DD	End date (inclusive)

Example

curl -H "Authorization: Bearer apex_your-key" \
  "https://apexhoops.fyi/api/v1/player/203999/history?from=2026-01-01"

Response

{
  "count": 45,
  "data": [
    {
      "snapshot_date": "2026-01-01",
      "player_id": 203999,
      "position": 5,
      "player_name": "Nikola Jokic",
      "minutes": 16200.0,
      "apex_per_36": 11.5
    }
  ]
}

Error Codes

Status	Meaning
200	Success
400	Invalid request parameters
401	Invalid or missing API key
404	Player not found
429	Rate limit exceeded
500	Internal server error

Interested in API access? Contact us to get started.

API Documentation

Programmatic access to APEX player impact ratings.

Authentication

All API endpoints (except /api/v1/health) require an API key passed via the Authorization header:

curl -H "Authorization: Bearer apex_your-api-key" \
  https://apexhoops.fyi/api/v1/ratings

API keys are issued manually. Contact us for API access.

Rate Limits

Rate limits are enforced per API key on a rolling 1-hour window.

Tier	Requests / Hour
Basic	100
Commercial	1,000

Every response includes rate limit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 2026-03-28T15:00:00.000Z

Endpoints

GET/api/v1/health

Health check. No authentication required.

Response

{
  "status": "ok",
  "last_updated": "2026-03-27",
  "refreshed_at": "2026-03-28T12:00:00Z"
}

GET/api/v1/ratings

Fetch APEX ratings for all players. Returns all bridge metric columns.

Parameter	Type	Default	Description
position	1-3	all	Filter by position (1=G, 2=F, 3=C)
min_minutes	number	0	Minimum minutes played
limit	number	100	Max results (max: 500)

Example

curl -H "Authorization: Bearer apex_your-key" \
  "https://apexhoops.fyi/api/v1/ratings?position=5&min_minutes=5000&limit=10"

Response

{
  "count": 10,
  "data": [
    {
      "player_id": 203999,
      "position": 5,
      "player_name": "Nikola Jokic",
      "minutes": 18432.5,
      "raw_pm_per36": 10.2,
      "leverage_adj": 0.8,
      "age_adj": 1.1,
      "teammate_opp_adj": -0.3,
      "apex_per_36": 11.8,
      "team": "DEN",
      "is_active": true,
      "age": 31,
      "birthdate": "1995-02-19",
      "updated_at": "2026-03-28T12:00:00Z"
    }
  ]
}

GET/api/v1/player/:id

Fetch a single player's current ratings (all positions) and biographical data.

Response

{
  "player": {
    "player_id": 203999,
    "player_name": "Nikola Jokic",
    "height_str": "6-11",
    "weight": 284,
    "birthdate": "1995-02-19"
  },
  "ratings": [
    {
      "position": 5,
      "minutes": 18432.5,
      "raw_pm_per36": 10.2,
      "leverage_adj": 0.8,
      "age_adj": 1.1,
      "teammate_opp_adj": -0.3,
      "apex_per_36": 11.8,
      "team": "DEN",
      "is_active": true
    }
  ]
}

GET/api/v1/player/:id/history

Fetch historical APEX snapshots for a player over time.

Parameter	Type	Description
from	YYYY-MM-DD	Start date (inclusive)
to	YYYY-MM-DD	End date (inclusive)

Example

curl -H "Authorization: Bearer apex_your-key" \
  "https://apexhoops.fyi/api/v1/player/203999/history?from=2026-01-01"

Response

{
  "count": 45,
  "data": [
    {
      "snapshot_date": "2026-01-01",
      "player_id": 203999,
      "position": 5,
      "player_name": "Nikola Jokic",
      "minutes": 16200.0,
      "apex_per_36": 11.5
    }
  ]
}

Error Codes

Status	Meaning
200	Success
400	Invalid request parameters
401	Invalid or missing API key
404	Player not found
429	Rate limit exceeded
500	Internal server error

Interested in API access? Contact us to get started.