v1

latestOpenAPI 3.0.12026-08-0673352.8 KB
API-Version-2.0

Get a competition

Shows live and upcoming events of the given competiiton key

get/v2/odds/competitions/{key}

Path parameters

keystring required

key of a competition. It is constructed by sport key + category key + competition key; e.g. soccer-england-premier-league

Query parameters

frominteger

time range, Unix epoch time, i.e. seconds since January 1, 1970 midnight UTC; e.g. 1618997973 from + to must be sent together

tointeger

time range, Unix epoch time, i.e. seconds since January 1, 1970 midnight UTC; e.g. 1619042340 from + to must be sent together

marketsstring[]

If not empty, only display markets specified here. Note that all events in a given time-range will still be returned, even if the specified market is absent Must specify each market as a separate query param; e.g. ?markets=basketball.handicap&markets=basketball.moneyline Full list of markets: https://gist.github.com/kgravenreuth/6703e1e213aecac4d5728f2f699d34e7#file-markets-json

playersboolean

if true, include players information

limitinteger

Limit the number of events; e.g. 50

Response

CompetitionResponse

keystring

slug for this Competition. Composed of <sport-key>-<category-key>-<competition-key> as shown in the example value.

namestring

name of this Competition

Example response

{
  "category": {
    "key": "\"Tennis\"",
    "name": "\"tennis\""
  },
  "events": [
    {
      "away": {
        "abbreviation": "\"NAD\"",
        "key": "\"c886a-nadal-rafael\"",
        "name": "\"Rafael Nadal\"",
        "nationality": "\"ESP\""
      },
      "cutoffTime": "\"2021-06-09T09:00:00Z\"",
      "home": {
        "abbreviation": "\"NAD\"",
        "key": "\"c886a-nadal-rafael\"",
        "name": "\"Rafael Nadal\"",
        "nationality": "\"ESP\""
      },
      "id": 7498746,
      "key": "\"c886a-nadal-rafael-v-c8973-schwartzman-diego\"",
      "metadata": {
        "opinion": [
          {
            "marketKey": "basketball.handicap",
            "outcome": "home",
            "params": "handicap=-3",
            "probability": 0.47347018
          }
        ]
      },
      "name": "\"Rafael Nadal V Diego Schwartzman\"",
      "sequence": 127
    }
  ],
  "key": "\"tennis-atp-french-open-men-singles\"",
  "name": "\"French Open, Men Singles\"",
  "sport": {
    "key": "\"Tennis\"",
    "name": "\"tennis\""
  }
}
All 7 operations