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/comparisonAutenticació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 Consulta
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
event_id | string | obligatorio | ID 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 Solicitudes
cURL
# 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")]'Respuesta
Éxito (200)
{
"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 Respuesta
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 297
X-RateLimit-Reset: 1737853200
X-Data-Delay: 0
X-Request-Id: 1782526326424224-82519Esquema de Respuesta
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ón
| Campo | Tipo | Descripción |
|---|---|---|
market_type | string | Tipo de mercado (p. ej., moneyline, spread, total_runs) |
selection | string | Nombre de la selección (nombre del equipo, Over/Under, etc.) |
line | number | null | Valor de la línea (para spreads/totales); null para moneylines |
books | array | Precio de cada casa de apuestas para esta selección, ordenado de mejor precio primero |
book_holds | array | Hold (%) por casa para esta selección. Omitido cuando la casa no ha fijado precio en el lado contrario. |
Objeto Book Odds (books[])
| Campo | Tipo | Descripción |
|---|---|---|
sportsbook | string | ID de la casa de apuestas |
odds_american | number | Cuota americana |
odds_decimal | number | Cuota decimal |
timestamp | string | Hora 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[])
| Campo | Tipo | Descripción |
|---|---|---|
sportsbook | string | ID de la casa de apuestas |
hold | number | Hold (overround) %, calculado emparejando el precio de esta casa en ambos lados del mercado de la selección. |
Entendiendo el Hold
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 |
|---|---|
| < 2 | Mercado muy eficiente (casas sharp) |
| 2-5 | Mercado normal |
| 5-8 | Margen alto (típico para props) |
| > 8 | Margen muy alto |
Casos de Uso
Line Shopping
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 Obsoletas
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 Mercado
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 Relacionados
- 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