Introduction

OddsLink is a JSON API for live odds and prices. Every sportsbook, exchange and prediction market we cover is joined onto one shared fixture and returned in one response, in the same shape, whether the price came from a sportsbook’s posted line or an exchange’s resting order book.

What one response looks like

A fixture carries home_team and away_team; each of its bookmakers[] carries markets[]; each market carries outcomes[{name, price, point}]. A few things about that shape are worth knowing up front:

• Period is part of the market key. totals_f5 is the total runs market for the first 5 innings; a full-game market has no suffix. GET /v1/markets lists every key we serve and the period it carries.
• price is one number. Under the default oddsFormat=american it is always an integer; under oddsFormat=decimal it is a decimal number above 1. point is a decimal number and is absent on a moneyline.
• size is typed. A sportsbook’s posted limit, an exchange’s resting depth, and a prediction market’s contract count are three different quantities and are never rendered the same way; see the Odds guide.
• last_update can be null. That means we do not yet measure a fetch time for that book, never that the price is old.
• Errors are nested under error, with a stable code, a human message, a docs_url pointing back here, and a request_id for support.

Where to go next

1. Quickstart gets a first odds response on the page.
2. Authentication covers the X-API-Key header.
3. The Guides go one endpoint family at a time: odds, props and history.
4. The API Reference in the sidebar is generated straight from the OpenAPI file that also drives the code samples on this page and on the main site, so it can never drift from what the API actually returns.
5. Speed limits and Errors and the Reference tables (sport keys, bookmaker keys, market keys, per-book coverage) round out what a client needs to handle every case, not just the happy path.

Every plan can call every book; there is no regional gating and nothing is held back for a higher plan except request volume, request speed, player props and price history. See the main site’s pricing page for the current plans.