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/jsonimage/png- Description format
- OpenAPI 3.0.0, API version
3.0.0 - Links
- OpenAPI document
- Listed from
- Odds Api's published OpenAPI description
How to test the Odds-API.io - Real-Time Sports Betting Odds API (v3) in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- 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.
- 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.
- 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.