GET odds-by-tournaments

Возвращает коэффициенты для всех матчей в указанном турнире.

Эндпоинт

GET /v4/odds-by-tournaments

Параметры запроса

  • tournamentIds* (string) Список ID турниров, разделённых запятыми.
  • bookmakers (string) Docs.GetOddsByTournaments.bookmakers_param
  • language (string) (Необязательно) Код языка для переведённых меток (например, en, de, es). По умолчанию en.
  • verbosity (number) (Необязательно) Уровень детализации ответа.
  • oddsFormat (string) (Необязательно) Формат коэффициентов в ответе (например, decimal, american).

Пример запроса

GET /v4/odds-by-tournaments?tournamentIds=17&bookmakers=pinnacle&language=en&verbosity=3

Пример ответа

{
  "fixtureId": "id1000001761301153",
  "participant1Id": 35,
  "participant2Id": 34,
  "sportId": 10,
  "tournamentId": 17,
  "seasonId": 130281,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T19:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-06T23:17:08.202Z",
  "bookmakerOdds": {
    "pinnacle": {
      "bookmakerIsActive": true,
      "bookmakerFixtureId": "1626291706",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1626291706/#all",
      "suspended": false,
      "markets": {
        "1012": {
          "bookmakerMarketId": "line/29/1980/1626291706/56152425451/0/totals",
          "marketActive": true,
          "outcomes": {
            "1012": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "3.5/over",
                  "bookmakerChangedAt": "2026-04-13T09:24:46.990Z",
                  "changedAt": "2026-04-13T09:24:47.424Z",
                  "limit": 20000,
                  "playerName": null,
                  "price": 2.71,
                  "priceAmerican": "171",
                  "priceFractional": "171/100",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            },
            "1013": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "3.5/under",
                  "bookmakerChangedAt": "2026-04-13T09:11:04.603Z",
                  "changedAt": "2026-04-13T09:11:05.099Z",
                  "limit": 40241,
                  "playerName": null,
                  "price": 1.497,
                  "priceAmerican": "-201",
                  "priceFractional": "49/99",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            }
          }
        }
      }
    }
  }
}

Ответ (200 OK)

При успешном запросе сервер возвращает код статуса 200 и возвращает JSON-объект, содержащий матчи с их коэффициентами.

Поля верхнего уровня

  • fixtureId (string) Уникальный идентификатор матча, для которого нужно получить счёт.
  • participant1Id (number) Идентификатор первого участника.
  • participant2Id (number) Идентификатор второго участника.
  • sportId (number)Уникальный идентификатор вида спорта. Этот ID должен соответствовать существующему виду спорта.
  • tournamentId (number)Уникальный идентификатор турнира. Этот ID должен соответствовать существующему турниру.
  • seasonId (number|null) Идентификатор сезона, если применимо.
  • statusId (number) Код статуса матча (например, 0 = До матча, 1 = Запланирован, 2 = В игре, 3 = Завершён).
  • hasOdds (boolean) Указывает, доступны ли коэффициенты для этого матча.
  • startTime (string)Время начала в формате ISO 8601.
  • trueStartTime (string|null) Фактическое время начала, если отличается от запланированного (например, отложенный стартовый удар).
  • trueEndTime (string|null) Фактическое время окончания матча, если доступно.
  • updatedAt (string) Метка времени ISO 8601 последнего обновления (UTC).
  • bookmakerOdds (object) Коэффициенты, сгруппированные по slug букмекера:
    • bookmakerIsActive (boolean) Указывает, активен ли этот букмекер в данный момент для этого матча (обычно показывает, собираем ли мы данные у этого букмекера).
    • bookmakerFixtureId (string) Уникальный ID матча, используемый букмекером.
    • fixturePath (string) Ссылка на страницу ставки букмекера для данного матча.
    • suspended (boolean) Указывает, приостановлены ли в данный момент все рынки этого букмекера.
    • markets (object) Объект, содержащий идентификаторы рынков в качестве ключей и соответствующие данные рынков:
      • bookmakerMarketId (string) Внутренний ID рынка или путь, используемый букмекером.
      • marketActive (boolean) Указывает, активен ли в данный момент этот конкретный рынок.
      • outcomes (object) Сопоставление идентификаторов исходов с данными исходов:
        • players (object) Сопоставление идентификаторов игроков с ценами на уровне игрока:
          • active (boolean) Показывает, активны ли эти коэффициенты сейчас.
          • betslip (string|null) Глубокая ссылка на купон или идентификатор, если доступно.
          • bookmakerOutcomeId (string) Обозначение исхода у букмекера.
          • bookmakerChangedAt (string|null) Метка времени ISO 8601 последнего изменения, сообщённого букмекером, если предоставлена.
          • changedAt (string) Время последнего изменения коэффициентов.
          • limit (number|null) Максимально допустимая ставка для этих коэффициентов.
          • playerName (string|null) Имя игрока для player props рынков; null для стандартных рынков.
          • price (number) Коэффициент в десятичном формате.
          • priceAmerican (string) Коэффициент в американском формате (например, «-201», «171»).
          • priceFractional (string) Коэффициент в дробном формате (например, «49/99»).
          • mainLine (boolean) Указывает, является ли это основной линией рынка.
          • exchangeMeta (any|null) Дополнительные метаданные для букмекеров типа exchange (например, ликвидность, цена lay).

Примечания

  • Пауза между запросами к эндпоинту (лимит скорости): 1000ms
  • Если параметр bookmakers не указан, включаются коэффициенты всех доступных букмекеров.
  • Все метки времени указаны в UTC (ISO 8601).
  • Все три формата цены (price, priceAmerican, priceFractional) всегда возвращаются независимо от параметра oddsFormat.
Предыдущая страницаGET odds
Следующая страницаGET historical odds
Сообщить о проблеме
OddsPapi | Документация GET odds by tournaments