The Odds API · Example Payload

The Odds Api Get Odds Example

BettingOddsSportsScoresHistorical Data

The Odds Api Get Odds Example is an example object payload from The Odds API, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

requestresponse_headersresponse

Example Payload

Raw ↑ 
{
  "request": {
    "method": "GET",
    "url": "https://api.the-odds-api.com/v4/sports/basketball_nba/odds",
    "params": {
      "apiKey": "YOUR_API_KEY",
      "regions": "us",
      "markets": "h2h,spreads",
      "oddsFormat": "american",
      "dateFormat": "iso"
    }
  },
  "response_headers": {
    "x-requests-remaining": "498",
    "x-requests-used": "2",
    "x-requests-last": "2"
  },
  "response": [
    {
      "id": "7f0348f75d9f3d3bda52be5a73ea3f7b",
      "sport_key": "basketball_nba",
      "sport_title": "NBA",
      "commence_time": "2024-05-03T00:30:00Z",
      "home_team": "Boston Celtics",
      "away_team": "Miami Heat",
      "bookmakers": [
        {
          "key": "draftkings",
          "title": "DraftKings",
          "last_update": "2024-05-02T23:45:00Z",
          "markets": [
            {
              "key": "h2h",
              "last_update": "2024-05-02T23:45:00Z",
              "outcomes": [
                { "name": "Boston Celtics", "price": -280 },
                { "name": "Miami Heat", "price": 230 }
              ]
            },
            {
              "key": "spreads",
              "last_update": "2024-05-02T23:45:00Z",
              "outcomes": [
                { "name": "Boston Celtics", "price": -110, "point": -7.5 },
                { "name": "Miami Heat", "price": -110, "point": 7.5 }
              ]
            }
          ]
        },
        {
          "key": "fanduel",
          "title": "FanDuel",
          "last_update": "2024-05-02T23:42:00Z",
          "markets": [
            {
              "key": "h2h",
              "last_update": "2024-05-02T23:42:00Z",
              "outcomes": [
                { "name": "Boston Celtics", "price": -270 },
                { "name": "Miami Heat", "price": 220 }
              ]
            },
            {
              "key": "spreads",
              "last_update": "2024-05-02T23:42:00Z",
              "outcomes": [
                { "name": "Boston Celtics", "price": -112, "point": -7.5 },
                { "name": "Miami Heat", "price": -108, "point": 7.5 }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example in the catalog.
  • 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.
All 92 tools

Call it yourself

curl for this page
This example 
curl "https://apis.io/api/v1/examples/the-odds-api-get-odds-example"
All examples 
curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.