Skip to Content
Referencia de la APIComparación de cuotas

Comparación de Cuotas

Compara las cuotas de un evento específico entre múltiples casas de apuestas. Los resultados se organizan por mercado y selección, con cálculos de hold e identificación de la mejor y peor casa para cada selección.

GET /api/v1/odds/comparison

AutenticaciónPermalink for this section

Requiere API key. Disponible para todos los planes.

Las casas de apuestas incluidas en la comparación dependen del acceso a libros de tu plan. El plan gratuito compara DraftKings y FanDuel; los planes superiores incluyen más casas. Consulta Acceso a Libros por Plan.

Parámetros de ConsultaPermalink for this section

ParámetroTipoPor defectoDescripción
event_idstringobligatorioID del evento para comparar las cuotas

El parámetro event_id es obligatorio. Este endpoint devuelve una comparación detallada para un único evento.

Los parámetros market y sportsbook no están soportados en este endpoint — la respuesta siempre incluye todos los mercados y todas las casas a las que tiene acceso tu nivel. Filtra client-side por market_type de cada entrada, o usa /odds?event_id=...&market=... para filtrado de mercado en el servidor.

Ejemplos de SolicitudesPermalink for this section

# Comparar todas las cuotas de un evento específico curl -X GET "https://api.sharpapi.io/api/v1/odds/comparison?event_id=mlb_royals_whitesox_2026-06-26_b2" \ -H "X-API-Key: YOUR_API_KEY" # Solo moneyline — filtra client-side por market_type curl -s "https://api.sharpapi.io/api/v1/odds/comparison?event_id=mlb_royals_whitesox_2026-06-26_b2" \ -H "X-API-Key: YOUR_API_KEY" | jq '[.data[] | select(.market_type == "moneyline")]'

RespuestaPermalink for this section

Éxito (200)Permalink for this section

{ "data": [ { "market_type": "moneyline", "selection": "CHI White Sox", "line": null, "books": [ { "sportsbook": "fanduel", "odds_american": -140, "odds_decimal": 1.714, "timestamp": "2026-06-27T02:11:20.000Z" }, { "sportsbook": "draftkings", "odds_american": -145, "odds_decimal": 1.690, "timestamp": "2026-06-27T02:11:24.000Z" }, { "sportsbook": "betmgm", "odds_american": -150, "odds_decimal": 1.667, "timestamp": "2026-06-27T02:11:18.000Z" } ], "book_holds": [ { "sportsbook": "fanduel", "hold": 4.2 }, { "sportsbook": "draftkings", "hold": 4.7 }, { "sportsbook": "betmgm", "hold": 5.1 } ] }, { "market_type": "moneyline", "selection": "KC Royals", "line": null, "books": [ { "sportsbook": "betmgm", "odds_american": 130, "odds_decimal": 2.300, "timestamp": "2026-06-27T02:11:18.000Z" }, { "sportsbook": "draftkings", "odds_american": 125, "odds_decimal": 2.250, "timestamp": "2026-06-27T02:11:24.000Z" } ] } ], "pagination": { "limit": 0, "offset": 0, "count": 2, "has_more": false, "next_offset": null }, "updated_at": "2026-06-27T02:11:20.000Z" }

data es un array plano de entradas de comparación — una por combinación (mercado, selección). El array books dentro de cada entrada está ordenado de mejor precio primero, así que books[0] es el mejor precio disponible y books[books.length - 1] el peor. book_holds solo está presente cuando la casa ha fijado precio en ambos lados del mercado de la selección.

Cabeceras de RespuestaPermalink for this section

X-RateLimit-Limit: 300 X-RateLimit-Remaining: 297 X-RateLimit-Reset: 1737853200 X-Data-Delay: 0 X-Request-Id: 1782526326424224-82519

Esquema de RespuestaPermalink for this section

El campo data de la respuesta es un array plano de entradas de comparación — un objeto por combinación (mercado, selección) del evento. No hay campo success en el nivel superior ni objeto meta; los metadatos de paginación se devuelven en el objeto pagination del nivel superior y el tiempo del snapshot en updated_at.

Entrada de ComparaciónPermalink for this section

CampoTipoDescripción
market_typestringTipo de mercado (p. ej., moneyline, spread, total_runs)
selectionstringNombre de la selección (nombre del equipo, Over/Under, etc.)
linenumber | nullValor de la línea (para spreads/totales); null para moneylines
booksarrayPrecio de cada casa de apuestas para esta selección, ordenado de mejor precio primero
book_holdsarrayHold (%) por casa para esta selección. Omitido cuando la casa no ha fijado precio en el lado contrario.

Objeto Book Odds (books[])Permalink for this section

CampoTipoDescripción
sportsbookstringID de la casa de apuestas
odds_americannumberCuota americana
odds_decimalnumberCuota decimal
timestampstringHora ISO 8601 en que SharpAPI refrescó por última vez la fila de esta casa a través de su pipeline — avanza en cada ciclo de ingesta. Es una señal de frescura del feed / actividad; NO es cuándo cambió el precio por última vez. Consulta Entendiendo el campo timestamp.

Objeto Hold (book_holds[])Permalink for this section

CampoTipoDescripción
sportsbookstringID de la casa de apuestas
holdnumberHold (overround) %, calculado emparejando el precio de esta casa en ambos lados del mercado de la selección.

Entendiendo el HoldPermalink for this section

El campo book_holds de cada entrada muestra el margen incorporado de la casa de apuestas, por casa, para el mercado de esa selección:

  • Un hold más bajo significa un precio más eficiente (sharp).
  • Una amplia diferencia de holds entre casas para la misma selección significa que comparar líneas es especialmente valioso para ese mercado.
Hold (%)Interpretación
< 2Mercado muy eficiente (casas sharp)
2-5Mercado normal
5-8Margen alto (típico para props)
> 8Margen muy alto

Casos de UsoPermalink for this section

Line ShoppingPermalink for this section

El array books está ordenado de mejor precio primero, así que books[0] es el precio a tomar. Compara entre casas para la misma selección:

curl -s "https://api.sharpapi.io/api/v1/odds/comparison?event_id=mlb_royals_whitesox_2026-06-26_b2" \ -H "X-API-Key: YOUR_API_KEY" | jq '[.data[] | select(.market_type == "run_line")]'

Identificación de Líneas ObsoletasPermalink for this section

Busca casas que no se hayan actualizado recientemente revisando el timestamp de cada casa. Una casa con cuotas obsoletas puede ser lenta en ajustarse, creando valor temporal.

Eficiencia del MercadoPermalink for this section

Compara book_holds entre casas para una selección. Una amplia diferencia entre el hold más bajo y el más alto significa que comparar líneas es especialmente valioso para ese mercado.

Endpoints RelacionadosPermalink for this section

  • Snapshot de Cuotas - Obtén cuotas en bruto de casas de apuestas individuales
  • Mejores Cuotas - Obtén solo las mejores cuotas con consenso y hold
  • Delta de Cuotas - Obtén solo las cuotas que han cambiado desde una marca de tiempo dada
  • Cuotas en Lote - Recupera datos de comparación para múltiples eventos a la vez
Last updated on