The Bookmakers API from Odds-API.io — 4 operation(s) for bookmakers.
1 of 4 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/odds-api-io:odds-api-io-bookmakers-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: '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.9% uptime for reliability'
title: Odds-API.io - Real-Time Sports Betting Odds API (v3)…
contact: {}
version: 3.0.0
servers:
- url: https://api.odds-api.io/v3
tags:
- name: Bookmakers
paths:
/bookmakers:
get:
description: Fetch a list of supported bookmakers with their current status. `status` is `ok`, `degraded` (no odds update for 60+ minutes) or `down` (no odds update for 3+ hours on a book with 100+ active matches). Odds from a `down` bookmaker are left out of every odds endpoint and removed over the WebSocket until it recovers. `reason` is null when `ok`. For a `degraded` or `down` bookmaker it is `maintenance` (the bookmaker is temporarily offline on its side, such as an announced maintenance; a `degraded` bookmaker in maintenance still has its odds served) or `unavailable` (we temporarily have no fresh odds from this bookmaker).
tags:
- Bookmakers
summary: Get Bookmakers
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/models.Bookmaker'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
x-mint:
metadata:
description: List every bookmaker you can query through Odds-API.io, from sportsbooks to exchanges and prediction markets, with each bookmaker's name, active flag and live feed status.
security: []
operationId: getBookmakers
x-operation-id-source: derived
/bookmakers/selected:
get:
security:
- ApiKeyAuth: []
description: Fetch the list of bookmakers selected by the authenticated user
tags:
- Bookmakers
summary: Get Selected Bookmakers
parameters:
- description: API key for authentication
name: apiKey
in: query
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
additionalProperties: true
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
x-mint:
metadata:
description: Get the bookmakers selected on your account. The odds endpoints and WebSocket feed return prices from this selection, so check it before you fetch odds.
operationId: getBookmakersSelected
x-operation-id-source: derived
/bookmakers/selected/clear:
put:
security:
- ApiKeyAuth: []
description: Remove all selected bookmakers for the authenticated user. Rate limited to once every 12 hours; the cooldown may be shorter for newly created accounts.
tags:
- Bookmakers
summary: Clear Selected Bookmakers
parameters:
- description: API key for authentication
name: apiKey
in: query
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
additionalProperties: true
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
operationId: putBookmakersSelectedClear
x-operation-id-source: derived
/bookmakers/selected/select:
put:
security:
- ApiKeyAuth: []
description: Add bookmakers to the authenticated user
tags:
- Bookmakers
summary: Select Bookmakers
parameters:
- description: API key for authentication
name: apiKey
in: query
required: true
schema:
type: string
- example: '"Bet365,SingBet"'
description: Comma-separated list of bookmaker names (e.g. Bet365,SingBet)
name: bookmakers
in: query
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
additionalProperties: true
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.ErrorResponse'
x-mint:
metadata:
description: Add bookmakers to your account's selection with a comma-separated list of names, such as Bet365,SingBet. The odds endpoints and WebSocket use this list.
operationId: putBookmakersSelectedSelect
x-operation-id-source: derived
components:
schemas:
models.Bookmaker:
type: object
properties:
active:
type: boolean
createdAt:
type: string
format: date-time
example: '2026-08-01T09:00:00Z'
description: When the bookmaker was added to the API, in UTC (RFC3339). Absent for a small number of legacy entries.
name:
type: string
status:
type: string
enum:
- ok
- degraded
- down
example: ok
description: 'Bookmaker status. `degraded`: no odds update on any of the book''s matches for 60+ minutes. `down`: no update for 3+ hours while the book has 100+ active matches; its odds are then left out of every odds endpoint and removed over the WebSocket until it recovers. Books with fewer than 100 active matches are always `ok`.'
reason:
type:
- string
- 'null'
enum:
- maintenance
- unavailable
- null
example: maintenance
description: 'Why the status is not `ok`. Null when `ok`. `maintenance`: the bookmaker is temporarily offline on its side. `unavailable`: we temporarily have no fresh odds from this bookmaker.'
controllers.ErrorResponse:
type: object
properties:
error:
type: string
example: Error message
securitySchemes:
ApiKeyAuth:
type: apiKey
in: query
name: apiKey
description: Your Odds-API.io API key, sent as the apiKey query parameter. Get one at https://odds-api.io/pricing.
x-origin:
- url: https://api.odds-api.io/v3/docs/doc.json
format: swagger
version: '2.0'
converter:
url: https://github.com/mermade/oas-kit
version: 7.0.8