GET odds-by-tournaments

Recupera odds para todas as partidas de um torneio específico.

Endpoint

GET /v4/odds-by-tournaments

Parâmetros da requisição

• tournamentIds* (string) — Uma lista de IDs de torneio separados por vírgula.
• bookmakers* (string) — Lista de casas de apostas separadas por vírgula (obrigatório, máx. 3). Se usar betfair-ex, máx. 1.
• language (string) — (Opcional) Código de idioma para rótulos traduzidos (p. ex., en, de, es). Padrão: en.
• verbosity (number) — (Opcional) O nível de verbosidade para controlar o detalhamento da resposta.

Exemplo de requisição

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

Exemplo de resposta

{
  "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
                }
              }
            }
          }
        }
      }
    }
  }
}

Resposta (200 OK)

Em uma requisição bem-sucedida, o servidor responde com um código de status 200 e retorna um objeto JSON contendo as partidas com suas respectivas odds.

Campos de nível superior

• fixtureId (string) — O identificador único da partida para recuperar os placares.
• participant1Id (number) — ID do primeiro participante.
• participant2Id (number) — ID do segundo participante.
• sportId (number) — O identificador único do esporte. Esse ID deve corresponder a um esporte existente.
• tournamentId (number) — O identificador único do torneio. Esse ID deve corresponder a um torneio existente.
• seasonId (number|null) — ID da temporada, se aplicável.
• statusId (number) — Código de estado da partida (p. ex., 0 = Pré-jogo, 1 = Agendado, 2 = Ao vivo, 3 = Encerrado).
• hasOdds (boolean) — Indica se há dados de odds disponíveis para esta partida.
• startTime (string) — Horário de início em formato ISO 8601.
• trueStartTime (string|null) — Hora de início real, se diferente da agendada (p. ex., chute inicial atrasado).
• trueEndTime (string|null) — Hora de término real da partida, se disponível.
• updatedAt (string) — Carimbo de data/hora ISO 8601 da última atualização (UTC).
• bookmakerOdds (object) — Odds agrupadas por slug do bookmaker:
  • bookmakerIsActive (boolean) — Indica se esta casa de apostas está atualmente ativa para esta partida (geralmente indica se coletamos dados desta casa).
  • bookmakerFixtureId (string) — ID único da partida usado pelo bookmaker.
  • fixturePath (string) — Link para a página de apostas do bookmaker para essa partida.
  • suspended (boolean) — Indica se todos os mercados desta casa de apostas estão atualmente suspensos.
  • markets (object) — Objeto contendo IDs de mercado como chaves e seus respectivos dados de mercado:
    • bookmakerMarketId (string) — ID interno de mercado ou caminho usado pelo bookmaker.
    • marketActive (boolean) — Indica se este mercado específico está atualmente ativo.
    • outcomes (object) — Mapeamento de IDs de resultado para dados do resultado:
      • players (object) — Mapeamento de IDs de jogador para preços a nível do jogador:
        • active (boolean) — Indica se a odd está ativa no momento.
        • betslip (string|null) — Deep-link do bilhete ou identificador, se disponível.
        • bookmakerOutcomeId (string) — Rótulo do outcome do ponto de vista do bookmaker.
        • bookmakerChangedAt (string|null) — Carimbo ISO 8601 da última alteração reportada pela casa de apostas, se fornecido.
        • changedAt (string) — Timestamp da última alteração da odd.
        • limit (number|null) — A aposta máxima permitida para essa odd.
        • playerName (string|null) — Nome do jogador em mercados de player props; null em mercados padrão.
        • price (number) — Odds em formato decimal.
        • priceAmerican (string) — Odds em formato americano (p. ex., «-201», «171»).
        • priceFractional (string) — Odds em formato fracionário (p. ex., «49/99»).
        • mainLine (boolean) — Indica se esta é a linha principal do mercado.
        • exchangeMeta (any|null) — Metadados adicionais para casas de apostas do tipo exchange (p. ex., liquidez, preço lay).