---
title: "GET /events/{event_id}/odds"
method: GET
path: "/events/{event_id}/odds"
tags: ["Prices"]
---

# GET /events/{event_id}/odds

`GET /events/{event_id}/odds`

## Request

- Base URL: `https://api.sockodds.com/v1`
- URL: `https://api.sockodds.com/v1/events/{event_id}/odds`
- Auth: HTTP bearer

Current prices for one event, grouped by market: each market and outcome appears once, and each outcome lists every bookmaker's price in `prices`, best price first. Markets come in catalogue order, then period, subject and line; outcomes in the market's side order. Use `group_by=bookmaker` for one block per bookmaker instead (the shape v1 launched with). Each price counts as one object towards your allowance, plus one for the event, in either shape.

## Path parameters

- `event_id` string, required

## Query parameters

- `markets` string
- `regions` string
- `bookmakers` string
- `alternates` boolean
- `group_by` 'market' | 'bookmaker'
- `snapshots` 'opening' | 'closing' | 'opening,closing'

## Response `200`

Event prices

- union
  - OddsEventEnvelope
    - `data` OddsEvent, required: An event with its prices grouped by market (the default). Markets come in catalogue order, then period, subject and line.
      - `id` string, required
      - `name` string, required
      - `league` NamedKey, required
        - `key` string, required
        - `name` string, required
      - `scheduled_start` string, date-time, required
      - `status` 'scheduled' | 'live' | 'final' | 'postponed' | 'cancelled', required
      - `participants` Participant[], required
        - `role` 'home' | 'away' | 'competitor_1' | 'competitor_2', required: home and away in team sports. In tennis and UFC
        - `identity` union, required
          - NamedKey
            - `key` string, required
            - `name` string, required
          - object
            - `id` string, required
            - `name` string, required
      - `markets` PricedMarket[], required
        - `id` string, required
        - `key` string, required
        - `name` string, required
        - `period` string, required
        - `subject` union, required
          - NamedKey
            - `key` string, required
            - `name` string, required
          - object
            - `id` string, required
            - `name` string, required
        - `alternate` boolean, required: True when this line is not the market's main line. Alternate lines appear only with alternates=true.
        - `outcomes` PricedOutcome[], required: In the market's side order (home
          - `id` string, required
          - `name` string, required
          - `side` string, required: A catalogue side key or player runner ID
          - `line` number, nullable, required: The outcome's own line: home -6.5 with away +6.5. Null when the market has no line.
          - `prices` Price[], required: Every bookmaker price for this outcome, best first: highest decimal odds, then bookmaker key. prices[0] is the best price among the bookmakers asked for. A price with no current odds (snapshots only) comes last.
            - `bookmaker` string, required
            - `decimal_odds` number, nullable, required
            - `implied_probability` number, nullable, required
            - `available` boolean, required: Whether the quote is available and fresh. Stale or withdrawn quotes appear only when snapshots are requested and carry null current prices.
            - `opening` PriceSnapshot
              - …
            - `closing` PriceSnapshot
              - …
            - `observed_at` string, date-time, required
    - `meta` Meta, required
      - `count` integer, required
      - `cursor` string, nullable, required
    - `links` Links, required
      - `next` string, uri-reference, nullable, required
  - OddsEventByBookmakerEnvelope
    - `data` OddsEventByBookmaker, required: An event with its prices grouped by bookmaker (group_by=bookmaker), the shape v1 launched with.
      - `id` string, required
      - `name` string, required
      - `league` NamedKey, required
        - `key` string, required
        - `name` string, required
      - `scheduled_start` string, date-time, required
      - `status` 'scheduled' | 'live' | 'final' | 'postponed' | 'cancelled', required
      - `participants` Participant[], required
        - `role` 'home' | 'away' | 'competitor_1' | 'competitor_2', required: home and away in team sports. In tennis and UFC
        - `identity` union, required
          - NamedKey
            - `key` string, required
            - `name` string, required
          - object
            - `id` string, required
            - `name` string, required
      - `bookmakers` QuotedBookmaker[], required
        - `key` string, required
        - `name` string, required
        - `markets` QuotedMarket[], required
          - `id` string, required
          - `key` string, required
          - `name` string, required
          - `subject` union, required
            - NamedKey
              - …
            - object
              - …
          - `period` string, required
          - `outcomes` Outcome[], required
            - `id` string, required
            - `name` string, required
            - `side` string, required: A catalogue side key or player runner ID. Team sports name participants home and away; tennis and UFC name them competitor_1 and competitor_2
            - `line` number, nullable, required: The outcome's own line. On a handicap each outcome carries its own figure: home -6.5 with away +6.5, and in tennis competitor_1 -2.5 with competitor_2 +2.5 (games). Null when the market has no line.
            - `decimal_odds` number, nullable, required
            - `implied_probability` number, nullable, required
            - `available` boolean: Whether the current quote is available and fresh. Stale or withdrawn quotes appear only when snapshots are requested and carry null current prices.
            - `alternate` boolean, required
            - `bookmaker` string, required
            - `observed_at` string, date-time, required
            - `opening` PriceSnapshot
              - …
            - `closing` PriceSnapshot
              - …
    - `meta` Meta, required
      - `count` integer, required
      - `cursor` string, nullable, required
    - `links` Links, required
      - `next` string, uri-reference, nullable, required

## Other responses

- `default`: Request failed

---

[API](https://skmtc.dev/sockodds/apis/sockodds-api.md) · [All operations](https://skmtc.dev/sockodds/apis/sockodds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sockodds/apis/sockodds-api/revisions/f4c680d355be?raw)