---
title: "Get list of upcoming or live events with markets for a given Sport."
method: GET
path: "/v2/odds/events"
tags: ["API-Version-2.0"]
---

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

`GET /v2/odds/events`

`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

## Query parameters

- `sport` string, required
- `from` integer
- `to` integer
- `live` boolean
- `markets` string[]
- `players` boolean
- `limit` integer

## Response `200`

FixturesResponse

- FixturesResponse — FixturesResponse presents a list of upcoming fixtures for a given sport and date
  - `competitions` FixturesCompetition[] — list of all requested competitions and events
    - `category` Identifier — Identifier represents a name-key tuple which together identify a given entity such as a sport
      - `key` string — slug for this Identifier
      - `name` string — name of this Identifier
    - `events` FixtureListEntry[] — list of events which belong to this competition
      - `away` TeamIdentifier — TeamIdentifier identifies a team competitor for a given event
        - `abbreviation` string — abbreviation for this team's name
        - `key` string — slug for this Identifier
        - `name` string — name of this Identifier
        - `nationality` string — team country code
      - `cutoffTime` string — event cutoff time in string format "2006-01-02T15:04:05Z07:00" (RFC3339)
      - `home` TeamIdentifier — TeamIdentifier identifies a team competitor for a given event
        - `abbreviation` string — abbreviation for this team's name
        - `key` string — slug for this Identifier
        - `name` string — name of this Identifier
        - `nationality` string — team country code
      - `id` integer — unique ID for this Event
      - `key` string — slug for this Event
      - `name` string — name of this Event
      - `status` 'PRE_TRADING' | 'TRADING' | 'TRADING_LIVE' | 'RESULTED' | 'INTERRUPTED' | 'AWAITING_RESULTS' | 'POST_TRADING' | 'CANCELLED' — EventStatus presents the current status for a given Event
    - `key` string — slug for this Competition. Composed of <sport-key>-<category-key>-<competition-key> as shown in the example value.
    - `name` string — name of this Competition

## Other responses

- `400` — Error
- `401` — Error
- `404` — Error
- `500` — Error

---

[API](https://skmtc.net/cloudbet/apis/cloudbet-feed-api.md) · [All operations](https://skmtc.net/cloudbet/apis/cloudbet-feed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbet/cloudbet-feed-api/versions/304403f067b1/schema)