Sign in

v1

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

Get list of upcoming or live events with markets for a given Sport.

live query param returns all TRADING_LIVE events for a given sport. from + to query params are required if live = false in your request to specify a valid time-range to retrieve upcoming (TRADING + PRE_TRADING) events

get/v2/odds/events

Query parameters

sportstring required

sport to query events for, e.g. tennis

frominteger

time range for upcoming events, Unix epoch time, i.e. seconds since January 1, 1970 midnight UTC; e.g. 1618997973 Either live or from + to query params are REQUIRED in your request to specify a valid time-range. from can't be sent together with live. Also, from + to must be sent together

tointeger

time range for upcoming events, Unix epoch time, i.e. seconds since January 1, 1970 midnight UTC; e.g. 1619042340 Either live or from + to query params are REQUIRED in your request to specify a valid time-range. to can't be sent together with live. Also, from + to must be sent together

liveboolean

If true, return all TRADING_LIVE events If false, return TRADING + PRE_TRADING events false by default live can't be sent together with from or to query params

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

Response

FixturesResponse

Example response

{
  "competitions": [
    {
      "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\"",
          "name": "\"Rafael Nadal V Diego Schwartzman\""
        }
      ],
      "key": "\"tennis-atp-french-open-men-singles\"",
      "name": "\"French Open, Men Singles\""
    }
  ]
}