The Odds API

The Odds API — free tier with API key

📚 Open DataREACHABLEchecked 5h ago
AUTH APIKEYCORS AGENT HTTPS COMMERCIAL ?

The Odds API exposes a free-tier JSON API. Register for an API key if required; we verified a public or demo endpoint.

100REACHABILITY SCORE ⓘ
Status badge · for your READMEshipapis health badge: — · healthy
CHECK TIER · REACHABILITY

We probe without your API key. A 401/403 auth wall means the server is up — not a full health pass.

Uptime history
100%90d reachable
100%30d reachable
5hLast check · since JUL 8 · server OK
operationalpartialdownno data
Live response samplecaptured by our last successful check
GET https://api.the-odds-api.com/v4/sports?apiKey=YOUR_API_KEY

{
  "message": "API key is not valid. Get an API key at https://the-odds-api.com",
  "error_code": "INVALID_KEY",
  "details_url": "https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-key"
}
Call itcurl · fetch · python
curl "https://api.the-odds-api.com/v4/sports?apiKey=YOUR_API_KEY"
const res = await fetch("https://api.the-odds-api.com/v4/sports?apiKey=YOUR_API_KEY");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://api.the-odds-api.com/v4/sports?apiKey=YOUR_API_KEY")
print(res.json())
Endpoints · 6ReachableFULL DOCS ↗
Auth wall reachable — GET /v4/sports?apiKey=YOUR_API_KEY (key stripped)231 mschecked 5h ago
GET/v4/sports?apiKey=YOUR_API_KEYPROBED

The Odds API — free tier with API key

GET/v4

V4 — documented GET route.

GET/v4/1

V4 details by ID (example: 1).

GET/v4?limit=10

V4 — documented GET route.

GET/v4/search?q=test

Search by query parameters.

GET/v4/

V4 — documented GET route.

Machine-readable spec

We probe without your API key. A 401/403 auth wall means the server is up — not a full health pass. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

The Odds API: common questions

Is The Odds API free to use?

Yes — The Odds API is a free open data API. Free tier: Free tier — API key required. Whether the free tier allows commercial use is unclear — check the provider docs.

Does The Odds API need an API key?

Yes — The Odds API needs a free API key, which you pass on each request. Rate limits: Unpublished.

Can I call The Odds API from the browser?

Yes — The Odds API returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.

Is The Odds API up right now?

As of our last scheduled check, The Odds API is healthy with 100% uptime over 90 days and a 231 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.