---
title: "MLB fantasy scoring leaders (Pro)"
method: GET
path: "/v1/mlb/scoring/leaders"
tags: ["MLB"]
---

# MLB fantasy scoring leaders (Pro)

`GET /v1/mlb/scoring/leaders`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/mlb/scoring/leaders`
- Auth: API key in header `X-PlayCaller-Key`

Top fantasy scorers for any game day, ranked by total points. Uses the PlayCaller scoring engine with standard roto weights (H, HR, RBI, SB, R, BB for batters; IP, K, SV for pitchers).

Useful for identifying daily stack targets and late-swap pivots before lock.

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

## Query parameters

- `date` string, date
- `position` 'SP' | 'RP' | 'C' | '1B' | '2B' | '3B' | 'SS' | 'OF' | 'DH'
- `team` string
- `limit` integer

## Response `200`

Fantasy scoring leaderboard for date

- object
  - `success` boolean
  - `endpoint` string
  - `count` integer
  - `data` MLBPlayerStats[]
    - `rank` integer, nullable: Leaders endpoint only
    - `id` string, nullable: Leaders endpoint only
    - `player_name` string, nullable: Leaders endpoint only
    - `team` string
    - `position` string
    - `stat_date` string, date-time
    - `game_pk` string, nullable: Player-stats endpoint only
    - `fantasy_points` string: Numeric value returned as a string
    - `is_final` boolean
    - `is_starter` boolean, nullable: Player-stats endpoint only
    - `last_updated` string, date-time, nullable: Player-stats endpoint only
    - `batting` object
      - `h` integer: Hits
      - `r` integer: Runs Scored
      - `hr` integer: Home Runs
      - `rbi` integer: RBI
      - `sb` integer: Stolen Bases
      - `bb` integer: Walks
      - `ab` integer, nullable: At Bats — player-stats endpoint only
      - `pa` integer, nullable: Plate Appearances — player-stats endpoint only
    - `pitching` object, nullable
      - `ip` string: Innings Pitched, returned as a string (e.g. "6.2")
      - `w` integer: Wins
      - `k` integer: Strikeouts
      - `sv` integer: Saves
      - `hld` integer: Holds
      - `er` integer: Earned Runs
  - `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 tier required for this endpoint
- `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)