---
title: "Alpha Metrics for a player (Pro Insights+)"
method: GET
path: "/v1/{sport}/players/{id}/alpha"
tags: ["Multi"]
---

# Alpha Metrics for a player (Pro Insights+)

`GET /v1/{sport}/players/{id}/alpha`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/{sport}/players/{id}/alpha`
- Auth: API key in header `X-PlayCaller-Key`

Returns three proprietary ML-derived signals computed from the player's last 8 games:

- **Consistency Score (0–100)** — how stable the player's usage/floor is. Higher = more reliable starter.
- **Momentum Delta** — signed float. Positive = trending up vs. prior 3-game baseline; negative = cooling off.
- **Opportunity Ceiling** — 90th-percentile fantasy output from the sample window. Represents the player's peak upside.

Results are pre-computed weekly (Tuesday 3 AM ET, post-MNF) and cached. Fresh players compute on-the-fly.

**Tier access:** Pro Insights, Syndicate Alpha

## Path parameters

- `sport` 'nfl' | 'mlb' | 'nba', required
- `id` string, required

## Response `200`

Alpha Metrics

- object
  - `success` boolean
  - `data` object
    - `player_id` string
    - `full_name` string
    - `position` string
    - `team` string
    - `sport` string
    - `consistency_score` number, nullable: Usage/floor stability (0–100). Higher = more consistent starter.
    - `momentum_delta` number, nullable: Avg pts last 3 games minus avg games 4–6 back. Positive = trending up.
    - `opportunity_ceiling` number, nullable: 90th-percentile fantasy output from the last 8 games. Peak upside.
    - `sample_size` integer
    - `season` integer
    - `week_computed` integer, nullable
    - `computed_at` string, date-time
  - `meta` ResponseMeta
    - `sport` string
    - `league` string: Present on multi-sport (ESPN-backed) endpoints; mirrors sport unless a sport has sub-leagues (e.g. soccer: epl/mls).
    - `tier` string
    - `calls_remaining_this_month` integer
    - `documentation_url` string, uri

## Other responses

- `401`: Missing or invalid API key
- `403`: Pro Insights or Syndicate Alpha key required
- `404`: Insufficient data (< 4 historical games)
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)