# Scoreline API

One stable contract for live and historical sports events. Scoreline public identifiers, states, revisions, and capability names remain stable as coverage evolves. Every authenticated response includes X-Scoreline-Environment (`test` or `live`), derived exclusively from the API key; request parameters and headers can never select or override the environment.

API version: 1.0.0

Use /llms-product.txt for pricing, wedge, coverage honesty, and compare pointers.
Use /llms-full.txt for complete guide text and operation details.
Use /docs/openapi.json for the machine-readable API contract.
Use /docs/mcp for public documentation tools.
Use /docs/AGENTS.md for copy-ready coding-agent instructions.

Start here:
- Product facts: /llms-product.txt
- Pricing: /pricing
- Live games board: /games
- Coverage: /coverage
- Agents / MCP: /agents
- Quickstart: /docs/quickstart
- Build with AI: /docs/build-with-ai
- Connect an agent: /docs/connect-an-agent
- Compare: /compare/owls-insight · /compare/sharpapi · /compare/the-odds-api
- Test event: evt_ars_che_20260712

## Get started

- Make your first request: /docs/quickstart
- Build with AI: /docs/build-with-ai
- Connect an agent with MCP: /docs/connect-an-agent
- Authentication: /docs/authentication

## Build sports products

- Build with sports data: /docs/sports-data
- Stable event IDs: /docs/stable-event-ids

## Build market products

- Build with market data: /docs/market-data
- Work with market history: /docs/market-history

## Ship realtime

- Real-time streams: /docs/realtime

## Operate

- Coverage and freshness: /docs/coverage-and-freshness
- Data quality without exposing the supply chain: /docs/data-quality
- Operate a Scoreline integration: /docs/operate
- Errors: /docs/errors

## Recipes

- Build a live scoreboard: /docs/recipes/live-scoreboard
- Build a match center: /docs/recipes/match-center
- Compare market prices: /docs/recipes/compare-market-prices
- Chart market history and closing lines: /docs/recipes/market-history-and-closing-lines
- Build a market-signal board: /docs/recipes/market-signals
- Build a match-outlook app: /docs/recipes/match-outlook
- Export a research dataset: /docs/recipes/research-dataset

## Catalog

- Retrieve project capabilities and limits: /docs/api/get-project-capabilities — GET /v1/capabilities
- List competitions: /docs/api/list-competitions — GET /v1/competitions
- Retrieve a competition: /docs/api/get-competition — GET /v1/competitions/{competition_id}
- List competition seasons: /docs/api/list-competition-seasons — GET /v1/competitions/{competition_id}/seasons
- Retrieve competition standings: /docs/api/get-competition-standings — GET /v1/competitions/{competition_id}/standings
- List data coverage: /docs/api/list-coverage — GET /v1/coverage
- List teams and athletes: /docs/api/list-participants — GET /v1/participants
- Retrieve a team or athlete: /docs/api/get-participant — GET /v1/participants/{participant_id}
- Search sports data by name: /docs/api/search-catalog — GET /v1/search
- List sports: /docs/api/list-sports — GET /v1/sports

## Events

- List live or historical events: /docs/api/list-events — GET /v1/events
- Retrieve an event: /docs/api/get-event — GET /v1/events/{event_id}
- List a participant's completed events: /docs/api/list-participant-events — GET /v1/participants/{participant_id}/events

## Event resources

- Retrieve public handle and ticket percentages by market: /docs/api/get-event-betting-splits — GET /v1/events/{event_id}/betting-splits
- Retrieve head-to-head history: /docs/api/get-event-head-to-head — GET /v1/events/{event_id}/head-to-head
- Retrieve event lineups: /docs/api/get-event-lineups — GET /v1/events/{event_id}/lineups
- Retrieve momentum samples: /docs/api/get-event-momentum — GET /v1/events/{event_id}/momentum
- Retrieve normalized betting markets: /docs/api/get-event-odds — GET /v1/events/{event_id}/odds
- Retrieve an event capability: /docs/api/get-event-resource — GET /v1/events/{event_id}/resources/{capability}
- Retrieve shot locations and outcomes: /docs/api/get-event-shots — GET /v1/events/{event_id}/shots
- Retrieve event statistics: /docs/api/get-event-statistics — GET /v1/events/{event_id}/statistics
- Retrieve the event timeline: /docs/api/get-event-timeline — GET /v1/events/{event_id}/timeline

## Realtime

- Create a realtime socket token: /docs/api/create-realtime-token — POST /v1/realtime/token
- Stream one canonical event over SSE: /docs/api/stream-event-updates — GET /v1/stream/events/{event_id}
- Stream canonical market updates over SSE: /docs/api/stream-market-updates — GET /v1/stream/markets

## Markets

- Retrieve markets for an event: /docs/api/get-event-markets — GET /v1/events/{event_id}/markets
- Retrieve closing lines for an event market: /docs/api/get-event-market-closing-lines — GET /v1/events/{event_id}/markets/closing-lines
- Compare current event-market prices across venues: /docs/api/get-event-market-comparison — GET /v1/events/{event_id}/markets/comparison
- List market contracts for an event: /docs/api/list-event-market-contracts-by-event — GET /v1/events/{event_id}/markets/contracts
- Retrieve market history for an event: /docs/api/get-event-market-history — GET /v1/events/{event_id}/markets/history
- Retrieve consensus probabilities for one event market: /docs/api/get-event-market-consensus — GET /v1/events/{event_id}/markets/{market_id}/consensus
- Get composed pricing for one canonical market: /docs/api/get-event-market-pricing — GET /v1/events/{event_id}/markets/{market_id}/pricing
- List cross-venue divergence signals: /docs/api/list-market-divergences — GET /v1/markets/divergences
- List events with market intelligence: /docs/api/list-market-events — GET /v1/markets/events
- Retrieve event market intelligence: /docs/api/get-market-event — GET /v1/markets/events/{event_id}
- Retrieve closing lines: /docs/api/get-closing-lines — GET /v1/markets/events/{event_id}/closing-lines
- Compare current prices across venues: /docs/api/get-market-comparison — GET /v1/markets/events/{event_id}/comparison
- List market contracts for an event: /docs/api/list-event-market-contracts — GET /v1/markets/events/{event_id}/contracts
- Retrieve market history: /docs/api/get-market-history — GET /v1/markets/events/{event_id}/history
- Retrieve consensus probabilities for one market: /docs/api/get-market-consensus — GET /v1/markets/events/{event_id}/markets/{market_id}/consensus
- Retrieve the markets overview: /docs/api/get-markets-overview — GET /v1/markets/overview
- List currently eligible market signals: /docs/api/list-market-signals — GET /v1/markets/signals
- Export the current eligible market signals: /docs/api/export-market-signals — GET /v1/markets/signals/export
- List public market venues: /docs/api/list-market-venues — GET /v1/markets/venues
- List fresh bookmaker odds for one sport: /docs/api/list-current-odds — GET /v1/odds

## Analysis

- Retrieve a football pre-event outlook: /docs/api/get-pre-event-outlook — GET /v1/analysis/events/{event_id}/pre-event-outlook
- Retrieve recent form for an event's participants: /docs/api/get-event-recent-form — GET /v1/analysis/events/{event_id}/recent-form

## Market exports

- List market exports: /docs/api/list-market-exports — GET /v1/markets/exports
- Create a market-history export: /docs/api/create-market-export — POST /v1/markets/exports
- Preview a market-history export: /docs/api/preview-market-export — POST /v1/markets/exports/preview
- Retrieve a market export: /docs/api/get-market-export — GET /v1/markets/exports/{export_id}
- Create a short-lived export download: /docs/api/download-market-export — GET /v1/markets/exports/{export_id}/download

## Market alerts

- List market alerts: /docs/api/list-market-alerts — GET /v1/markets/alerts
- Create a market alert: /docs/api/create-market-alert — POST /v1/markets/alerts
- Retrieve a market alert: /docs/api/get-market-alert — GET /v1/markets/alerts/{alert_id}
- Update a market alert: /docs/api/update-market-alert — PATCH /v1/markets/alerts/{alert_id}
- Delete a market alert: /docs/api/delete-market-alert — DELETE /v1/markets/alerts/{alert_id}