The API Reference for every sport we cover

Authentication

Every request needs an API key. Pass it as a Bearer token in the Authorization header for production traffic, or as an api_key query parameter while testing in a browser. Keys are scoped to a plan and can be rotated at any time from your dashboard without downtime — issue a new key, update your app, then revoke the old one.

Base URL & versioning

All endpoints are served from https://api.orbistats.com and prefixed with a version segment. The current stable version is v1. We never introduce breaking changes inside a version — new fields are additive, and breaking changes ship as a new version with a migration guide and an overlap window.

Rate limits

Limits are enforced per API key and returned on every response so you can back off before hitting them.

Pagination

List endpoints (fixtures, results, teams, players, historical matches) are paginated with page and per_page, or a cursor for high-volume historical queries. Every list response includes a meta.pagination block with the next cursor or page.

Response format

Every response — success or failure — shares the same envelope, so your parsing code doesn't branch per endpoint.

Errors

Errors return the matching HTTP status code and a structured body describing what went wrong and how to fix it.

Upcoming fixtures for a sport, filterable by league, team or date range. Powers schedule pages, "next match" widgets and fixture-list views.

A single fixture with full detail — venue, officials, broadcast info and links to its lineups, events and odds once available.

Every match currently in play, with the live score, clock, period and the most recent event. Poll every 5–10 seconds, or switch to the WebSocket API for push updates.

Completed matches with the final score, filterable the same way as fixtures. Use it to build results grids, form guides and head-to-head history.

The current league table — played, won, drawn, lost, goal difference and points — updated automatically after every result is confirmed.

Season-level team statistics — shots, possession, cards and sport-specific metrics. A matching /statistics/player/{player_id} endpoint returns individual player numbers for the same season.

Pre-match and live odds normalized into a single format across sportsbooks, so you compare markets without writing a parser per book.

Team and player directories with stable IDs used throughout the rest of the API. /teams/{team_id} and /players/{player_id} return full profiles including current squad, competitions and season stats links.

Starting lineups, formations and substitutes for a fixture, plus a chronological event feed — goals, cards, substitutions and sport-specific events — as they're confirmed.

Every league and tournament we cover for a sport, with country, tier and current season, so you can build a competition picker without hardcoding a list.

Season-by-season historical match data for backtesting models, building head-to-head pages and long-run trend analysis. Depth varies by sport and competition — check the coverage matrix below.

Register an HTTPS endpoint once and Orbistats pushes a payload the moment something changes — no polling loop to maintain. Each payload is signed so you can verify it came from us.

A persistent connection for clients that need sub-second updates — live scoreboards, trading desks and in-play odds boards. Subscribe to one or more channels after connecting.