GET odds

Recupera cuotas detalladas y metadatos para un partido deportivo específico de varios bookmakers.

Endpoint

GET /v4/odds

Parámetros de la petición

• fixtureId* (string) — ID único del partido
• bookmakers (string) — (Opcional) Lista separada por comas de casas de apuestas
• oddsFormat (string) — (Opcional) Formato de cuotas deseado. Opciones: fractional, decimal, american
• language (string) — (Opcional) Código de idioma para etiquetas traducidas
• verbosity (number) — (Opcional) Nivel de detalle de la respuesta. Un valor más alto devuelve una salida más detallada.

Ejemplo de petición

GET /v4/odds?fixtureId=id1000003969653792&bookmakers=pinnacle&language=en&verbosity=3

Respuesta de muestra

{
  "fixtureId": "id1000003969653792",
  "participant1Id": 1302,
  "participant2Id": 4872,
  "sportId": 10,
  "tournamentId": 39,
  "seasonId": 130951,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T17:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-08T18:00:30.461Z",
  "externalProviders": {
    "betradarId": 69653792,
    "mollybetId": "2026-04-13,625,676",
    "opticoddsId": "20260413B49C7BD7",
    "lsportsId": null,
    "txoddsId": null,
    "sofascoreId": 15676262,
    "betgeniusId": 13679074,
    "flashscoreId": "nDaPAq53",
    "pinnacleId": 1627730447,
    "oddinId": null
  },
  "statusName": "Pre-Game",
  "participant1Name": "FC Fredericia",
  "participant1ShortName": "Fredericia",
  "participant1Abbr": "FRE",
  "participant2Name": "Vejle BK",
  "participant2ShortName": "Vejle",
  "participant2Abbr": "VEJ",
  "sportName": "Soccer",
  "tournamentSlug": "superliga",
  "categorySlug": "denmark",
  "categoryName": "Denmark",
  "tournamentName": "Superliga",
  "bookmakerOdds": {
    "pinnacle": {
      "bookmakerIsActive": true,
      "bookmakerFixtureId": "1627730447",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1627730447/#all",
      "suspended": false,
      "markets": {
        "10286": {
          "bookmakerMarketId": "1627730447/6020879114/1628099951",
          "marketActive": true,
          "outcomes": {
            "10287": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "1628099962",
                  "bookmakerChangedAt": null,
                  "changedAt": "2026-04-13T09:00:11.194Z",
                  "limit": 125,
                  "playerName": null,
                  "price": 4.01,
                  "priceAmerican": "301",
                  "priceFractional": "301/100",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            }
          }
        }
      }
    }
  }
}

Desglose de campos de la respuesta

Campos de nivel superior

• fixtureId string — ID interno único para el partido.
• participant1Id number — El ID del primer participante.
• participant2Id number — El ID del segundo participante.
• sportId number — ID de deporte
• tournamentId number — ID de torneo
• seasonId number|null — (Opcional) El ID de la temporada.
• statusId number — El estado actual del partido.
• hasOdds boolean — Indica si el partido tiene cuotas disponibles.
• startTime string — Hora de inicio en formato ISO 8601.
• trueStartTime string|null — La hora real de inicio del partido, si está disponible.
• trueEndTime string|null — La hora real de fin del partido, si está disponible.
• updatedAt string — Hora de última actualización en formato ISO 8601.
• statusName string — Estado del partido legible (p. ej., «Pre-Game», «In-Play», «Ended»).
• participant1Name string — El nombre del primer participante (en el idioma solicitado).
• participant1ShortName string — Nombre corto de visualización del primer participante. Traducido si se establece el parámetro language.
• participant1Abbr string — Abreviatura de 3 letras del primer participante. Traducido si se establece el parámetro language.
• participant2Name string — El nombre del segundo participante (en el idioma solicitado).
• participant2ShortName string — Nombre corto de visualización del segundo participante. Traducido si se establece el parámetro language.
• participant2Abbr string — Abreviatura de 3 letras del segundo participante. Traducido si se establece el parámetro language.
• sportName string — Nombre del deporte.
• tournamentSlug string — Identificador del torneo apto para URL.
• categorySlug string — Slug de la categoría de competición (p. ej., «england»).
• categoryName string — Nombre visible de la categoría (p. ej., «England»).
• tournamentName string — Nombre completo del torneo (traducido si se establece el parámetro language).
• externalProviders (object) — IDs de proveedores externos:
  • betradarId (number|null) — (Opcional) El ID asignado por Betradar.
  • mollybetId (string|null) — (Opcional) El ID único asignado por Mollybet.
  • opticoddsId (string|null) — (Opcional) El ID único asignado por Opticodds.
  • lsportsId (number|null) — (Opcional) El ID único asignado por LSports.
  • txoddsId (number|null) — (Opcional) El ID único asignado por TXOdds.
  • sofascoreId (number|null) — (Opcional) El ID asignado por Sofascore.
  • betgeniusId (number|null) — (Opcional) El ID asignado por Betgenius.
  • flashscoreId (string|null) — (Opcional) El ID asignado por Flashscore.
  • pinnacleId (number|null) — (Opcional) El ID asignado por Pinnacle.
  • oddinId (number|null) — (Opcional) El ID asignado por Oddin.

Objeto bookmakerOdds

• bookmakerIsActive boolean — Indica si esta casa de apuestas está actualmente activa para este partido (suele indicar si recopilamos datos de esta casa).
• bookmakerFixtureId string — Identificador propio del partido en la casa de apuestas.
• fixturePath string — URL directa al partido en el sitio web de la casa de apuestas.
• 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 — Identificador interno del mercado de 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 esta selección se está ofreciendo actualmente.
      • betslip string|null — Enlace profundo al boleto o identificador, si está disponible.
      • bookmakerOutcomeId string — Identificador de resultado de la casa de apuestas (p. ej., «3.5/under», «home»).
      • 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 ISO 8601 del último cambio registrado en nuestro sistema.
      • limit number|null — Importe máximo de apuesta permitido para esta selección.
      • 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).