{
  "opencollection": "1.0.0",
  "info": {
    "name": "The Odds Events Historical API",
    "version": "4.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "apiKey",
      "value": "{{apiKey}}",
      "placement": "query"
    }
  },
  "items": [
    {
      "info": {
        "name": "Historical",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Historical Sport Odds",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.the-odds-api.com/v4/historical/sports/:sport/odds",
            "params": [
              {
                "name": "sport",
                "value": "",
                "type": "path",
                "description": "Sport key from /v4/sports."
              },
              {
                "name": "apiKey",
                "value": "",
                "type": "query",
                "description": "Your API key."
              },
              {
                "name": "date",
                "value": "",
                "type": "query",
                "description": "ISO 8601 timestamp for the historical snapshot (e.g., 2023-09-16T12:00:00Z)."
              },
              {
                "name": "regions",
                "value": "",
                "type": "query",
                "description": "Comma-separated regions for bookmakers."
              },
              {
                "name": "markets",
                "value": "",
                "type": "query",
                "description": "Comma-separated betting markets."
              },
              {
                "name": "oddsFormat",
                "value": "",
                "type": "query",
                "description": "Odds format: decimal or american."
              },
              {
                "name": "bookmakers",
                "value": "",
                "type": "query",
                "description": "Comma-separated bookmaker IDs."
              },
              {
                "name": "eventIds",
                "value": "",
                "type": "query",
                "description": "Comma-separated event IDs to filter."
              }
            ]
          },
          "docs": "Returns a snapshot of odds at a specific historical timestamp. Available from June 6, 2020 onwards at 10-minute intervals (5-minute from Sept 2022). Quota: 10 credits per region per market."
        },
        {
          "info": {
            "name": "Get Historical Sport Events",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.the-odds-api.com/v4/historical/sports/:sport/events",
            "params": [
              {
                "name": "sport",
                "value": "",
                "type": "path",
                "description": "Sport key from /v4/sports."
              },
              {
                "name": "apiKey",
                "value": "",
                "type": "query",
                "description": "Your API key."
              },
              {
                "name": "date",
                "value": "",
                "type": "query",
                "description": "ISO 8601 timestamp for the historical query."
              },
              {
                "name": "eventIds",
                "value": "",
                "type": "query",
                "description": "Comma-separated event IDs to filter."
              },
              {
                "name": "commenceTimeFrom",
                "value": "",
                "type": "query",
                "description": "Filter to events commencing after this datetime."
              },
              {
                "name": "commenceTimeTo",
                "value": "",
                "type": "query",
                "description": "Filter to events commencing before this datetime."
              }
            ]
          },
          "docs": "Returns event data from a specific historical timestamp. Quota: 1 credit (free if no results returned)."
        },
        {
          "info": {
            "name": "Get Historical Event Odds",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.the-odds-api.com/v4/historical/sports/:sport/events/:eventId/odds",
            "params": [
              {
                "name": "sport",
                "value": "",
                "type": "path",
                "description": "Sport key from /v4/sports."
              },
              {
                "name": "eventId",
                "value": "",
                "type": "path",
                "description": "Event ID for the historical snapshot."
              },
              {
                "name": "apiKey",
                "value": "",
                "type": "query",
                "description": "Your API key."
              },
              {
                "name": "date",
                "value": "",
                "type": "query",
                "description": "ISO 8601 timestamp for the historical snapshot."
              },
              {
                "name": "regions",
                "value": "",
                "type": "query",
                "description": "Comma-separated regions for bookmakers."
              },
              {
                "name": "markets",
                "value": "",
                "type": "query",
                "description": "Comma-separated betting markets (all market types accepted)."
              },
              {
                "name": "oddsFormat",
                "value": "",
                "type": "query",
                "description": "Odds format: decimal or american."
              },
              {
                "name": "dateFormat",
                "value": "",
                "type": "query",
                "description": "Date format: iso or unix."
              }
            ]
          },
          "docs": "Returns odds for a specific event at a historical snapshot timestamp. Useful for backtesting, line-movement analysis, and reconstructing the full market state of a single event. Quota: 1 credit per unique market per region."
        }
      ]
    }
  ],
  "bundled": true
}