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ónEnlace permanente a esta sección

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 ConsultaEnlace permanente a esta sección

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 SolicitudesEnlace permanente a esta sección

# 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")]'

RespuestaEnlace permanente a esta sección

Éxito (200)Enlace permanente a esta sección

{ "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", "price_updated_at": "2026-06-27T01:58:03.000Z" }, { "sportsbook": "draftkings", "odds_american": -145, "odds_decimal": 1.690, "timestamp": "2026-06-27T02:11:24.000Z", "price_updated_at": "2026-06-27T02:07:51.000Z" }, { "sportsbook": "betmgm", "odds_american": -150, "odds_decimal": 1.667, "timestamp": "2026-06-27T02:11:18.000Z", "price_updated_at": "2026-06-27T01:36:40.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", "price_updated_at": "2026-06-27T01:36:40.000Z" }, { "sportsbook": "draftkings", "odds_american": 125, "odds_decimal": 2.250, "timestamp": "2026-06-27T02:11:24.000Z", "price_updated_at": "2026-06-27T02:07:51.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 RespuestaEnlace permanente a esta sección

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

Esquema de RespuestaEnlace permanente a esta sección

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ónEnlace permanente a esta sección

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[])Enlace permanente a esta sección

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.
price_updated_atstring|undefinedHora ISO 8601 en que se actualizó por última vez el precio de esta casa. Se mueve cuando cambian el precio, la línea, el estado en vivo, la suspensión, el libro de órdenes o el tamaño disponible, no cuando SharpAPI vuelve a leer una fila sin cambios. Se omite cuando no hay hora de cambio. Consulta Entendiendo el campo timestamp.

Objeto Hold (book_holds[])Enlace permanente a esta sección

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 HoldEnlace permanente a esta sección

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 UsoEnlace permanente a esta sección

Line ShoppingEnlace permanente a esta sección

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 ObsoletasEnlace permanente a esta sección

Busca casas cuyo precio no se haya movido recientemente revisando el price_updated_at de cada casa. Una casa con cuotas obsoletas puede ser lenta en ajustarse, creando valor temporal.

Eficiencia del MercadoEnlace permanente a esta sección

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 RelacionadosEnlace permanente a esta sección

  • 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