The Odds API

aid: the-odds-api
name: The Odds API
description: The Odds API provides sports betting odds from over 40 major bookmakers worldwide. Access current and historical
  odds for head-to-head, spreads, totals, and outrights markets across 100+ sports. Endpoints cover live scores, event listings,
  participants, and historical odds snapshots dating back to June 2020. Quota is consumed per request based on the number
  of regions and markets requested. All requests require an API key.
kind: contract
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-11-13'
  method: derived
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/the-odds-api.png
tags:
- Betting
- Odds
- Sports
- Scores
- Historical Data
created: '2025-02-08'
modified: '2026-05-25'
url: https://raw.githubusercontent.com/api-evangelist/the-odds-api/refs/heads/main/apis.yml
specificationVersion: '0.23'
apis:
- aid: the-odds-api:the-odds-api-events-api
  name: The Odds API Events API
  description: Event listings without odds.
  humanURL: https://the-odds-api.com/
  baseURL: https://api.the-odds-api.com/v4
  tags:
  - Event
  tags_raw:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/the-odds-api-events-api-openapi.yml
  - type: Documentation
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: GettingStarted
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: Signup
    url: https://the-odds-api.com/#get-access
- aid: the-odds-api:the-odds-api-historical-api
  name: The Odds API Historical API
  description: Historical odds and event snapshots.
  humanURL: https://the-odds-api.com/
  baseURL: https://api.the-odds-api.com/v4
  tags:
  - Historical
  properties:
  - type: OpenAPI
    url: openapi/the-odds-api-historical-api-openapi.yml
  - type: Documentation
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: GettingStarted
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: Signup
    url: https://the-odds-api.com/#get-access
- aid: the-odds-api:the-odds-api-odds-api
  name: The Odds API Odds API
  description: Current odds from bookmakers.
  humanURL: https://the-odds-api.com/
  baseURL: https://api.the-odds-api.com/v4
  tags:
  - Odds
  properties:
  - type: OpenAPI
    url: openapi/the-odds-api-odds-api-openapi.yml
  - type: Documentation
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: GettingStarted
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: Signup
    url: https://the-odds-api.com/#get-access
- aid: the-odds-api:the-odds-api-participants-api
  name: The Odds API Participants API
  description: Teams and players in a sport.
  humanURL: https://the-odds-api.com/
  baseURL: https://api.the-odds-api.com/v4
  tags:
  - Participants
  properties:
  - type: OpenAPI
    url: openapi/the-odds-api-participants-api-openapi.yml
  - type: Documentation
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: GettingStarted
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: Signup
    url: https://the-odds-api.com/#get-access
- aid: the-odds-api:the-odds-api-scores-api
  name: The Odds API Scores API
  description: Live and recent game scores.
  humanURL: https://the-odds-api.com/
  baseURL: https://api.the-odds-api.com/v4
  tags:
  - Scores
  properties:
  - type: OpenAPI
    url: openapi/the-odds-api-scores-api-openapi.yml
  - type: Documentation
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: GettingStarted
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: Signup
    url: https://the-odds-api.com/#get-access
- aid: the-odds-api:the-odds-api-sports-api
  name: The Odds API Sports API
  description: Available sports and their keys.
  humanURL: https://the-odds-api.com/
  baseURL: https://api.the-odds-api.com/v4
  tags:
  - Sports
  properties:
  - type: OpenAPI
    url: openapi/the-odds-api-sports-api-openapi.yml
  - type: Documentation
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: GettingStarted
    url: https://the-odds-api.com/liveapi/guides/v4/
  - type: Signup
    url: https://the-odds-api.com/#get-access
common:
- type: AgenticAccess
  url: agentic-access/the-odds-api-agentic-access.yml
- type: DomainSecurity
  url: security/the-odds-api-domain-security.yml
- type: Authentication
  url: authentication/the-odds-api-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/the-odds-api
- type: Website
  url: https://the-odds-api.com/
- type: Documentation
  url: https://the-odds-api.com/liveapi/guides/v4/
- type: Signup
  url: https://the-odds-api.com/#get-access
- type: GitHubOrganization
  url: https://github.com/the-odds-api
- type: StatusPage
  url: https://status.the-odds-api.com/
- type: Plans
  url: plans/the-odds-api-plans-pricing.yml
- type: RateLimits
  url: rate-limits/the-odds-api-rate-limits.yml
- type: FinOps
  url: finops/the-odds-api-finops.yml
- type: SpectralRuleset
  url: rules/the-odds-api-rules.yml
- type: JSONSchema
  url: json-schema/the-odds-api-event-schema.json
- type: JSONLDContext
  url: json-ld/the-odds-api-context.jsonld
- type: Vocabulary
  url: vocabulary/the-odds-api-vocabulary.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com