statshawk
REST APIAnalysis

GET /v1/analysis/stat-board?competition=&date=&stat= — slate over-rate board. date is interpreted in the competition's local scoreboard timezone; for MLB this is US Eastern time.

cost 10 unitsany plan
GET
/v1/analysis/stat-board

Authorization

X-API-Key<token>

Raw API key (sk_live_… or sk_test_…). Preferred for REST clients. Keys are read-only; the environment prefix is the only key role. See https://statshawk.ai/docs/getting-started/permissions

In: header

Query Parameters

competition*string

Competition slug (e.g. mlb) or minted comp_... id. Required.

date*string

Slate date in YYYY-MM-DD, interpreted in the competition's local scoreboard timezone. MLB dates are resolved in US Eastern time.

Formatdate
stat*string

The measure to rank, either a base key (pts) or phase-qualified key (batting.h). Friendly aliases accepted by player-prop are accepted here too. Unknown stats are a 400.

window?|

Recent-game window for the over-rate. Clamped to [1, 60]; default 20.

Formatint32
limit?|

Maximum entries in full_slate. Clamped to [1, 200]; default 50.

Formatint64
min_games?|

Minimum games_in_window for an entry to appear in recommended (small samples still rank in full_slate). Clamped to [1, 60]; default 10.

Formatint32

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/analysis/stat-board?competition=string&date=2019-08-24&stat=string"
{
  "data": {
    "competition": "comp_0a1b2c3d4e5f6g7h8i9j0k1l2m",
    "date": "2019-08-24",
    "full_slate": [
      {
        "context": null,
        "games_in_window": 0,
        "opponent": {
          "name": "string",
          "team_id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "person": {
          "bio": {
            "baseball": null,
            "birth_country": null,
            "display_name": "string",
            "dob": "2019-08-24",
            "full_name": "string",
            "height_inches": null,
            "position": null,
            "weight_lbs": null
          },
          "external_ids": {
            "property1": [
              "string"
            ],
            "property2": [
              "string"
            ]
          },
          "id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "projection_source": "lineup",
        "season_rate": 0.1,
        "team": {
          "name": "string",
          "team_id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "window_rate": 0.1
      }
    ],
    "games_with_lineups": 0,
    "games_without_lineups": 0,
    "line": 0.1,
    "recommended": [
      {
        "context": null,
        "games_in_window": 0,
        "opponent": {
          "name": "string",
          "team_id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "person": {
          "bio": {
            "baseball": null,
            "birth_country": null,
            "display_name": "string",
            "dob": "2019-08-24",
            "full_name": "string",
            "height_inches": null,
            "position": null,
            "weight_lbs": null
          },
          "external_ids": {
            "property1": [
              "string"
            ],
            "property2": [
              "string"
            ]
          },
          "id": "per_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "projection_source": "lineup",
        "season_rate": 0.1,
        "team": {
          "name": "string",
          "team_id": "team_0a1b2c3d4e5f6g7h8i9j0k1l2m"
        },
        "window_rate": 0.1
      }
    ],
    "stat": "string",
    "window": 0
  },
  "meta": {
    "cache": "HIT",
    "fetched_at": "2025-10-15T18:30:00Z",
    "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
    "source": "postgres",
    "version": "v1"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "property1": null,
    "property2": null
  }
}