betstamp logoDocs

Betstamp Pro Markets & Data API

The Betstamp Pro API gives you direct access to our curated sportsbook data: real-time and historical markets, fixtures, players, teams, and seasons across the major North American leagues and key global soccer competitions.

Data Delivery Modes

Pull API

The Pull API is ideal for retrieving the latest markets snapshot whenever you need it. Use it for:

Use cases:

  • Scheduled polling (e.g., every few seconds/minutes)
  • On-demand pricing or modeling workflows
  • Backfilling and reconciling internal datasets

Markets Stream (SSE)

The Markets Stream delivers real-time pricing updates over Server-Sent Events (SSE). It's designed for:

Use cases:

  • Live market-movement tracking
  • Trading interfaces and alerting systems
  • Low-latency models that react to odds changes

Core Endpoints

GET

/markets

Retrieve markets filtered by league, book, bet type, period, and more.

Supported Market Types:

MoneylinesSpreadsTotalsPropsFutures

Filters:

  • Live/pre-game filters
  • Alternate lines support

Reference Data Endpoints

Access comprehensive reference data for players, teams, fixtures, and seasons.

GET

/players

GET

/teams

GET

/fixtures

GET

/seasons

Available as lists or ID-keyed maps for efficient lookups.

Supported sports & coverage

NFLNCAAFNBANCAABMLBNHLUFCMLSPremier LeagueSerie ALaLigaLigue 1BundesligaChampions LeagueGolf

Exact league coverage may vary by endpoint.

Authentication & rate limits

Authentication

All endpoints require an API key supplied via the X-API-KEY header. Requests without valid authentication are rejected with JSON error responses.

“X-API-KEY: YOUR_API_KEY_HERE”

Rate Limits

We enforce per-second throttles (default 4 RPS) and monthly quotas depending on your account plan. If you exceed a limit, the response clearly indicates whether the per-second or monthly cap was reached.

Typical Integration Patterns

1

Schedule Market Polling

Fetch market snapshots at regular intervals for pricing models and analytics.

2

Real-Time Trading Dashboard

Connect to SSE stream for live market updates and build responsive trading interfaces.

3

Market Monitoring Alerts

Monitor specific markets for threshold changes and trigger automated alerts.

4

Reference Data Enrichment

Combine market data with player, team, and fixture metadata for enhanced context.