Sign in

v1

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

Get an event

Shows all available main markets by default

get/v2/odds/events/{id}

Path parameters

idinteger required

id of an event; e.g. 5837480

Query parameters

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

Response

EventResponse

cutoffTimestring

event cutoff time in string format "2006-01-02T15:04:05Z07:00" (RFC3339)

endTimestring

the time when the event ends in string format "2006-01-02T15:04:05Z07:00" (RFC3339), optional.

gradingDurationinteger

estimated grading duration in minutes between event finish time and bet complete time (not available for outrights) for example, value 30 means most of the bets will be graded after 30 minutes

idinteger

unique ID for this Event

keystring

slug for this Event

marketsobject

mapping between market key and all associated markets for this Event

namestring

name of this Event

resultedTimestring

resulted time available after end of event in string format "2006-01-02T15:04:05Z07:00" (RFC3339)

sequenceinteger

sequential update number for this Event

settlementobject

reserved field for possible future use, empty currently

The map key will be the score types, such as period=default

status'PRE_TRADING' | 'TRADING' | 'TRADING_LIVE' | 'RESULTED' | 'INTERRUPTED' | 'AWAITING_RESULTS' | 'POST_TRADING' | 'CANCELLED'

EventStatus presents the current status for a given Event

typeinteger

EventType presents the type of an event which affects the markets format

Example response

{
  "away": {
    "abbreviation": "\"NAD\"",
    "key": "\"c886a-nadal-rafael\"",
    "name": "\"Rafael Nadal\"",
    "nationality": "\"ESP\""
  },
  "competition": {
    "category": {
      "key": "\"Tennis\"",
      "name": "\"tennis\""
    },
    "key": "\"tennis-atp-french-open-men-singles\"",
    "name": "\"French Open, Men Singles\""
  },
  "cutoffTime": "\"2021-06-09T09:00:00Z\"",
  "endTime": "\"2021-06-09T10:45:00Z\"",
  "gradingDuration": 30,
  "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\"",
  "resultedTime": "\"2021-06-09T11:00:00Z\"",
  "sequence": 127,
  "sport": {
    "key": "\"Tennis\"",
    "name": "\"tennis\""
  }
}