CTG Pro Markings API – LLM Guide
================================

Purpose:
  This file gives language models a quick map of the CTG Pro Markings API,
  where to find the full human documentation, and where to find a machine-
  readable catalog of all data-set fields.

Base HTTP API:
  - Base URL: https://api.cleaningtheglass.com/pro/
  - Auth: X-API-KEY header (string API key)

Primary endpoints:
  - GET /game_status
      * Check processing status of games.
      * Docs page: /getting-the-data/
  - GET /markings_3d
      * Retrieve rich “markings” data for a specific game.
      * Docs page: /getting-the-data/

Key documentation sections (VitePress pages):
  - Home: /
  - Getting the Data: /getting-the-data/
  - Concepts: /concepts/
  - Data Sets overview: /data-sets/

Data sets (marking types documented under /data-sets/):
  - anthro:
      * Title: Anthro Measurements
      * Docs page: /data-sets/anthro
  - chances:
      * Title: Chances
      * Docs page: /data-sets/chances
  - closeouts:
      * Title: Closeouts
      * Docs page: /data-sets/closeouts
  - contested-rebounds:
      * Title: Contested Rebound Touches
      * Docs page: /data-sets/contested-rebounds
  - deflections:
      * Title: Deflections
      * Docs page: /data-sets/deflections
  - dribbles:
      * Title: Dribbles
      * Docs page: /data-sets/dribbles
  - drives:
      * Title: Drives
      * Docs page: /data-sets/drives
  - falls:
      * Title: Falls
      * Docs page: /data-sets/falls
  - fouls:
      * Title: Fouls
      * Docs page: /data-sets/fouls
  - free-throws:
      * Title: Free Throws
      * Docs page: /data-sets/free-throws
  - interior-shot-contests:
      * Title: Interior Shot Contests
      * Docs page: /data-sets/interior-shot-contests
  - interior-shots:
      * Title: Interior Shots
      * Docs page: /data-sets/interior-shots
  - jump-shot-contests:
      * Title: Jump Shot Contests
      * Docs page: /data-sets/jump-shot-contests
  - jump-shots:
      * Title: Jump Shots
      * Docs page: /data-sets/jump-shots
  - jumps:
      * Title: Jumps
      * Docs page: /data-sets/jumps
  - passes:
      * Title: Passes
      * Docs page: /data-sets/passes
  - possession-touches:
      * Title: Possession Touches
      * Docs page: /data-sets/possession-touches
  - possessions:
      * Title: Possessions
      * Docs page: /data-sets/possessions
  - rebounds:
      * Title: Rebounds
      * Docs page: /data-sets/rebounds
  - shots:
      * Title: Shots
      * Docs page: /data-sets/shots
  - turnovers:
      * Title: Turnovers
      * Docs page: /data-sets/turnovers

Machine-readable field catalog:
  - File: /fields.json
  - Shape: { "<data_set_slug>": { title, description, fields: { <field>: { type, unit, description } } } }

Notes about schema stability and evolution:
  - New fields and sometimes new marking types will be added over time.
  - Existing fields are not removed or changed without significant advance notice.
  - Client ingestion code should be tolerant to extra fields and new marking types.