IN DEVELOPMENT · FREE DURING BETA

OddsDirect API documentation

Everything you need to get ready for the OddsDirect beta: platform status, concepts, odds formats and errors. The API reference will be published here at launch.

Status: OddsDirect is in development and not live yet. This page explains the subject and what the API is being built to do. Endpoints, response formats and limits will be published in the docs when the beta opens.

Status

OddsDirect is in development. This is the current state of each part of the platform:

ComponentStatus
REST API (pre-match and live odds)IN DEVELOPMENT
WebSocket streamIN DEVELOPMENT
Player marketsIN DEVELOPMENT
API keysHANDED OUT IN DISCORD AT BETA LAUNCH
API reference (endpoints, responses)IN DEVELOPMENT

Quickstart

  1. Join the Discord to get a beta key when the beta opens.
  2. Read the concepts below so the data model is familiar.
  3. Try the odds maths in the Python guide.

Authentication

Coming soonAPI keys will be issued to beta users. How to send them will be documented here at launch.

Endpoints and responses

Coming soonBase URL, endpoints, parameters and real example responses. We won't publish examples until they are real.

Sports and markets

Football is a core focus: pre-match, in-play and player markets. See Football Odds API for the market families and Player Props API for player markets. The complete list of sports, competitions and market identifiers will be published here at launch.

WebSocket and data freshness

Live prices will be pushed over a WebSocket stream; pre-match data changes more slowly and suits REST requests. Read bet365 WebSocket for the snapshot-plus-updates pattern and reconnect handling.

Stream reference: coming soonConnection URL, authentication and message types.

Errors

StatusUsual meaningWhat to do
200SuccessUse the response
400Invalid request parametersFix the request; do not retry unchanged
401 / 403Missing, invalid or revoked keyCheck the key; do not retry in a loop
404Unknown resource, e.g. an ended fixtureDrop it from your list
429Rate limit reachedBack off and retry later
5xxTemporary server problemRetry with exponential backoff

General HTTP conventions. OddsDirect's exact error bodies will be documented at launch.

Glossary

TermMeaning
FixtureA single event, e.g. one football match, with teams, competition and start time.
MarketA question you can bet on within a fixture, e.g. match result or total goals.
SelectionOne possible answer in a market, e.g. Home, Draw or Away, each with its own price.
LineThe number a market is built around, e.g. 2.5 in over/under 2.5 goals or −0.5 in a handicap.
Decimal oddsTotal return per 1 unit staked, including the stake: 2.50 returns 2.50.
Implied probability1 / decimal odds. The chance the price implies, before removing the margin.
Overround (margin)How far a market's implied probabilities add up above 100%.
In-play / liveMarkets offered while the event is in progress.
SuspendedA selection temporarily closed for betting, typically during key moments in live play.
Snapshot vs updateA snapshot is the full current state; updates are the changes since. Resync with a snapshot after any gap.

Frequently asked questions

When will the API reference be published?

When the beta opens. Until then this page covers concepts and status, and API-specific sections are marked as coming soon.

How will authentication work?

With API keys issued to beta users. The exact method will be documented at launch. Keep keys server-side and never commit them to code repositories.

What data format will the API use?

JSON over HTTPS, plus a WebSocket stream for real-time updates.

Where can I ask technical questions?

In the OddsDirect Discord.

Be first in line for a beta key

The API will be free during the beta. Keys go out in our Discord first.

Related