Odds-API.io

Odds-API.io - Real-Time Sports Betting Odds API (v3)

Odds-API.io is a powerful sports betting odds comparison API, providing real-time data from 450+ bookmakers across 34 sports with near zero latency. 450+…

Data & analytics#sports--fitness

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Odds-API.io is a powerful sports betting odds comparison API, providing real-time data from 450+ bookmakers across 34 sports with near zero latency.

  • 450+ bookmakers supported
  • 34 sports including Football, Basketball, Tennis, Esports and more
  • Real-time odds with close to zero latency
  • Pre-match & In-play odds coverage
  • 99.99% uptime for reliability

Endpoints 33

Arbitrage Bets

  • GETGet arbitrage betting opportunities/arbitrage-bets?apiKey=string&bookmakers="Bet365,SingBet"Returns prematch arbitrage opportunities where every leg uses one of the specified bookmakers, sorted by profit margin (highest first). Opportunities are…

Bookmakers

  • GETGet Bookmakers/bookmakersFetch a list of supported bookmakers with their current status. status is ok, degraded (no odds update and no completed scrape for 60+ minutes) or down (no…
  • GETGet Selected Bookmakers/bookmakers/selected?apiKey=stringFetch the list of bookmakers selected by the authenticated user
  • PUTClear Selected Bookmakers/bookmakers/selected/clear?apiKey=stringRemove all selected bookmakers for the authenticated user. Rate limited to once every 12 hours; the cooldown may be shorter for newly created accounts.
  • PUTSelect Bookmakers/bookmakers/selected/select?apiKey=string&bookmakers="Bet365,SingBet"Add bookmakers to the authenticated user

Events

  • GETGet Events/events?apiKey=string&sport="football"Returns events with enhanced filtering and pagination
  • GETGet Live Events/events/live?apiKey=stringReturns all currently live events from all sports with optional sport filter
  • GETSearch Events/events/search?apiKey=string&query="Liverpool"Searches events by team or league name and returns up to 10 results ranked by relevance. By default only upcoming (not yet started, not cancelled) events are…
  • GETGet Event by ID/events/:id?apiKey=stringReturns a single event by its unique identifier

Historical

  • GETGet Historical Events/historical/events?apiKey=string&sport="football"&league="england-premier-league"&from="2026-01-01T00:00:00Z"&to="2026-01-31T23:59:59Z"Returns finished events for a given sport and league within a date range. Maximum date span is 31 days. Historical data is available from December 2025 onwards.
  • GETSearch Historical Events/historical/events/search?apiKey=string&query="Brann"Searches finished events by team name across all leagues, optionally scoped to a sport. Maximum date span is 31 days (defaults to the trailing 31 days).…
  • GETGet Historical Odds/historical/odds?apiKey=string&eventId="123456"&bookmakers="Bet365,SingBet"Returns closing odds for a finished event from selected bookmakers, including scores.
  • GETGet Historical Closing Lines/historical/closing-lines?apiKey=string&sport="football"&leagues="england-premier-league,spain-laliga"&from="2026-01-01T00:00:00Z"&to="2026-12-31T23:59:59Z"&markets="ML,Totals"&bookmakers="Bet365,Unibet"Returns closing odds for every settled event across one or more leagues in a date range, in a single request. Paid plans only.

Leagues

  • GETGet Leagues/leagues?apiKey=string&sport="football"Returns a list of leagues (name, slug, event count) for a specified sport

Odds

  • GETGet Event Odds/odds?apiKey=string&eventId="123456"&bookmakers="Bet365,Unibet"Returns odds comparison for a specific event from selected bookmakers.
  • GETGet Odds Movements/odds/movements?apiKey=string&eventId="123456"&bookmaker=string&market=stringReturns the prematch odds movements for one market line of an event from a bookmaker: the opening price, the latest price and recent price changes (how many…
  • GETGet Odds for Multiple Events/odds/multi?apiKey=string&eventIds=string&bookmakers=stringReturns odds comparison for up to 10 events from selected bookmakers (counts as only 1 request).
  • GETGet updated event odds since a given timestamp/odds/updated?apiKey=string&since=0&bookmaker=string&sport=stringReturns updated event odds for a specific bookmaker since a given UNIX timestamp (max 90 seconds old). The response is a delta: each event carries only the…
  • GETGet Odds Summary/odds/summary?apiKey=string&eventId="123456"Best, average, median, worst and margin-free fair price per market line across bookmakers, for odds comparison pages. A bookmaker counts only while its prices…
  • GETGet Odds Summary for Multiple Events/odds/summary/multi?apiKey=string&eventIds=stringThe odds summary for up to 10 events in one request, counted as one request. Events that are not found are left out. Available on Growth plans and above.…

Participants

  • GETGet Participants/participants?apiKey=string&sport="football"Returns participants (teams) for a specified sport
  • GETGet Participant by ID/participants/:id?apiKey=stringReturns a single participant by its unique identifier
  • GETGet Participant Logo/participants/:id/logo?apiKey=stringReturns the team/participant crest as a PNG image, served from the Odds-API domain. Logos are cached server-side; responses carry Cache-Control: public,…

Sports

  • GETGet Sports/sportsReturns a list of sports with name and slug

Dropping Odds

  • GETGet Dropping Odds/dropping-odds?apiKey=stringReturns odds that have dropped significantly from their opening values. Data is pre-computed and updated every ~30 seconds. Results are sorted by sort: the…

Value Bets

  • GETGet Value Bets/value-bets?apiKey=string&bookmaker="Bet365"Returns pre-match value bets for a specific bookmaker with optional match info. Value bets are pre-match only: matches that have started (in-play) or are…

Mappings

  • GETGet Native ID Mappings/mappings?apiKey=string&bookmaker=PolymarketMaps our events and selections to a bookmaker's own identifiers, so our prices can be matched to the bookmaker's own markets. For Polymarket, marketId is the…

Markets

  • GETGet Markets/marketsReturns all available markets per sport. Use shape to parse a market's odds and prematch/live to see where it's offered. Built from events in the last 14 days…

Outrights

  • GETList Outrights/outrights?apiKey=string&sport=golfLists outright (futures) tournaments for a sport, sorted by start date. bookmakerCount is how many bookmakers you can request in /outrights/odds currently…
  • GETGet Outright Odds/outrights/odds?apiKey=string&id=1001&bookmakers=DraftKings,KalshiReturns Winner, Top 3, Top 5, Top 6, Top 10 and Top 20 (dead heat), Top 5 (Incl. Ties), Top 10 (Incl. Ties) and Top 20 (Incl. Ties) (ties paid in full) and…
  • GETGet Outright Results/outrights/results?apiKey=string&id=1000Returns final positions and the winners of each market for one outright. results and winners are empty until the outright is settled. Tied golfers share a…

Settlement

  • GETGet Settlements/settlements?apiKey=string&eventIds=74919888,73722728Returns the settlement record for up to 50 events: status, whether the result is final, and the final scores. Every id gets an answer, including cancelled and…
  • POSTGrade Selections/settlements/grade?apiKey=stringGrades up to 50 bet selections against final results. Each selection is the event id, market name, side and, where the market has one, the line (hdp) and…

API details

Base URL
https://api.odds-api.io/v3
Authentication
An API key in the apiKey query parameter
Operations
33 operations on 33 pathsGET 30PUT 2POST 1
Main resources
Odds 6Bookmakers 4Events 4Historical 4Outrights 3Participants 3Settlement 2Arbitrage Bets 1Dropping Odds 1Leagues 1
Response formats
application/json image/png
Description format
OpenAPI 3.0.0, API version 3.0.0

How to test the Odds-API.io - Real-Time Sports Betting Odds API (v3) in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Odds-API.io - Real-Time Sports Betting Odds API (v3) collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the apiKey query parameter. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get arbitrage betting opportunities” (GET /arbitrage-bets?apiKey=string&bookmakers="Bet365,SingBet"), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Odds-API.io - Real-Time Sports Betting Odds API (v3)?

Odds-API.io is a powerful sports betting odds comparison API, providing real-time data from 450+ bookmakers across 34 sports with near zero latency. 450+… It is listed under Data & analytics and has 33 endpoints.

Who publishes the Odds-API.io - Real-Time Sports Betting Odds API (v3)?

It is listed from Odds-API.io's public API description (an OpenAPI document), not published by Odds-API.io on Swastik Codes. Anyone who controls odds-api.io can claim the profile by adding a DNS TXT record.

What is the base URL of the Odds-API.io - Real-Time Sports Betting Odds API (v3)?

Requests go to https://api.odds-api.io/v3. Endpoint paths are added to this base URL.

How do I authenticate with the Odds-API.io - Real-Time Sports Betting Odds API (v3)?

With an API key in the apiKey query parameter.

How many endpoints does the Odds-API.io - Real-Time Sports Betting Odds API (v3) have?

33 operations on 33 paths (30 GET, 2 PUT, 1 POST). The largest groups are Odds, Bookmakers, Events, Historical.

Is forking the Odds-API.io - Real-Time Sports Betting Odds API (v3) free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.