GET odds-by-tournaments

Recupera cuotas para todos los partidos de un torneo específico.

Endpoint

GET /v4/odds-by-tournaments

Parámetros de la petición

• tournamentIds* (string) — Una lista de IDs de torneos separados por comas.
• bookmakers (string) — Docs.GetOddsByTournaments.bookmakers_param
• language (string) — (Opcional) Código de idioma para etiquetas traducidas (p. ej., en, de, es). El valor predeterminado es en.
• verbosity (number) — (Opcional) El nivel de detalle para controlar la cantidad de información en la respuesta.
• oddsFormat (string) — (Opcional) Formato de las cuotas en la respuesta. (p. ej. decimal, american).

Ejemplo de petición

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

Ejemplo de respuesta

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

Respuesta (200 OK)

En una petición exitosa, el servidor responde con el código de estado 200 y devuelve un objeto JSON que contiene los partidos con sus cuotas asociadas.

Campos de nivel superior

• fixtureId (string) — El identificador único del partido para recuperar los marcadores.
• participant1Id (number) — ID del primer participante.
• participant2Id (number) — ID del segundo participante.
• sportId (number) — El identificador único para el deporte. Este ID debe corresponder a un deporte existente.
• tournamentId (number) — El identificador único para el torneo. Este ID debe corresponder a un torneo existente.
• seasonId (number|null) — ID de la temporada, si corresponde.
• statusId (number) — Código de estado del partido (p. ej., 0 = Pre-partido, 1 = Programado, 2 = En juego, 3 = Finalizado).
• hasOdds (boolean) — Indica si hay datos de cuotas disponibles para este partido.
• startTime (string) — Hora de inicio en formato ISO 8601.
• trueStartTime (string|null) — Hora de inicio real si difiere de la programada (p. ej., saque retrasado).
• trueEndTime (string|null) — Hora de finalización real del partido, si está disponible.
• updatedAt (string) — Marca de tiempo ISO 8601 de la última actualización (UTC).
• bookmakerOdds (object) — Cuotas agrupadas por slug de la casa de apuestas:
  • bookmakerIsActive (boolean) — Indica si esta casa de apuestas está actualmente activa para este partido (suele indicar si recopilamos datos de esta casa).
  • bookmakerFixtureId (string) — ID único del partido usado por la casa de apuestas.
  • fixturePath (string) — Enlace a la página de apuestas de la casa para el partido.
  • suspended (boolean) — Indica si todos los mercados de esta casa de apuestas están actualmente suspendidos.
  • markets (object) — Objeto que contiene los IDs de mercado como claves y sus datos correspondientes:
    • bookmakerMarketId (string) — ID interno de mercado o ruta utilizada por la casa de apuestas.
    • marketActive (boolean) — Indica si este mercado específico está actualmente activo.
    • outcomes (object) — Mapa de IDs de resultado a datos de resultado:
      • players (object) — Mapa de IDs de jugador a precios a nivel de jugador:
        • active (boolean) — Indica si las cuotas están actualmente activas.
        • betslip (string|null) — Enlace profundo al boleto o identificador, si está disponible.
        • bookmakerOutcomeId (string) — Etiqueta del resultado según la casa de apuestas.
        • bookmakerChangedAt (string|null) — Marca de tiempo ISO 8601 del último cambio reportado por la casa de apuestas, si se proporciona.
        • changedAt (string) — Marca de tiempo del último cambio en las cuotas.
        • limit (number|null) — La apuesta máxima permitida para esas cuotas.
        • playerName (string|null) — Nombre del jugador para mercados de player props; null para mercados estándar.
        • price (number) — Cuota en formato decimal.
        • priceAmerican (string) — Cuota en formato americano (p. ej., «-201», «171»).
        • priceFractional (string) — Cuota en formato fraccional (p. ej., «49/99»).
        • mainLine (boolean) — Indica si esta es la línea principal del mercado.
        • exchangeMeta (any|null) — Metadatos adicionales para casas de apuestas tipo exchange (p. ej., liquidez, precio lay).