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:
| Component | Status |
|---|---|
| REST API (pre-match and live odds) | IN DEVELOPMENT |
| WebSocket stream | IN DEVELOPMENT |
| Player markets | IN DEVELOPMENT |
| API keys | HANDED OUT IN DISCORD AT BETA LAUNCH |
| API reference (endpoints, responses) | IN DEVELOPMENT |
Quickstart
- Join the Discord to get a beta key when the beta opens.
- Read the concepts below so the data model is familiar.
- Try the odds maths in the Python guide.
Authentication
Endpoints and responses
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.
Errors
| Status | Usual meaning | What to do |
|---|---|---|
200 | Success | Use the response |
400 | Invalid request parameters | Fix the request; do not retry unchanged |
401 / 403 | Missing, invalid or revoked key | Check the key; do not retry in a loop |
404 | Unknown resource, e.g. an ended fixture | Drop it from your list |
429 | Rate limit reached | Back off and retry later |
5xx | Temporary server problem | Retry with exponential backoff |
General HTTP conventions. OddsDirect's exact error bodies will be documented at launch.
Glossary
| Term | Meaning |
|---|---|
| Fixture | A single event, e.g. one football match, with teams, competition and start time. |
| Market | A question you can bet on within a fixture, e.g. match result or total goals. |
| Selection | One possible answer in a market, e.g. Home, Draw or Away, each with its own price. |
| Line | The number a market is built around, e.g. 2.5 in over/under 2.5 goals or −0.5 in a handicap. |
| Decimal odds | Total return per 1 unit staked, including the stake: 2.50 returns 2.50. |
| Implied probability | 1 / 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 / live | Markets offered while the event is in progress. |
| Suspended | A selection temporarily closed for betting, typically during key moments in live play. |
| Snapshot vs update | A 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.