Splits de Apuestas
Obtén splits de apuestas públicas (handle % y bet %) de DraftKings, Circa Sports y BetMGM.
Cada fila corresponde a un evento en una fuente. Incluye la proporción de tickets (bets_pct) y, cuando la fuente la publica, la proporción del dinero (handle_pct) en cada lado de los mercados que cubre: moneyline, spread y total. En fútbol, un moneyline puede tener tres lados (local, empate y visitante): consulta Moneyline a tres vías más abajo. Úsalo para ver de qué lado apuesta el público y dónde el dinero pesa más que el número de tickets. Para ver cómo cambiaron los splits de un evento a lo largo del tiempo, usa el Historial de Splits descrito más abajo.
GET /api/v1/splitsAutenticaciónEnlace permanente a esta sección
Requiere API key. Requiere plan Pro (229 $/mes) o superior.
¿Qué son los splits de apuestas?Enlace permanente a esta sección
Handle % es el porcentaje del dinero total apostado en cada lado. Bet % es el porcentaje del total de tickets (apuestas realizadas) en cada lado.
La diferencia entre bet % y handle % revela el dinero sharp. Si el 30 % de los tickets concentra el 60 % del dinero, los apostantes sharp están en ese lado.
Fuentes de DatosEnlace permanente a esta sección
| Fuente | Tipo | Qué incluye | Frecuencia de Actualización |
|---|---|---|---|
| DraftKings | Casa recreativa (~35 % de cuota del mercado de EE. UU.) | Handle % y bet % | Cada 5 minutos |
| Circa Sports | Casa orientada a sharps (atrae profesionales) | Handle % y bet % | Varias veces al día |
| BetMGM | Casa recreativa — derivada de su propio campo de porcentaje de apuestas públicas | Solo bet % — los valores de handle_pct son null | Intermitente |
Comparar los splits de DraftKings (recreativa) frente a Circa (sharp) revela dónde el dinero profesional diverge del público.
La cobertura de casas de apuestas está fijada en estas tres. No crece con el cupo de casas de apuestas de tu plan: seleccionar más casas, o subir de nivel, no añade fuentes de splits. Las únicas otras filas son las filas consensus, descritas más abajo. Como BetMGM solo aporta un porcentaje de tickets, la brecha bet %/handle % que revela el dinero sharp no puede calcularse en las filas de BetMGM. El historial incluye muestras de DraftKings, Circa, BetMGM y consensus capturadas durante las 48 horas de retención. BetMGM solo publica porcentajes de tickets; sus porcentajes de dinero siguen siendo null.
consensus es una etiqueta, no una casa de apuestas. Cuando todas las fuentes que cubren un evento publican cifras idénticas, esas filas se fusionan en una sola con "sportsbook": "consensus". La API la aplica de forma sintética: nunca aparece en /api/v1/sportsbooks, aunque /splits?sportsbook=consensus sí filtra por ella. Un filtro sportsbook=draftkings no devuelve las filas fusionadas. Las filas consensus de fútbol no son filas de casas fusionadas: llevan porcentajes de apuestas públicas de todo el mercado, no los de una sola casa de apuestas, y son las únicas filas con empate.
Cobertura de fútbolEnlace permanente a esta sección
Los splits de fútbol cubren ocho competiciones. Fíltralas con sport=soccer, o con league y los IDs de abajo.
| Competición | league | consensus (tres vías) | draftkings (dos vías) |
|---|---|---|---|
| Premier League | england_-_premier_league | Sí | Sí |
| La Liga | spain_-_la_liga | Sí | — |
| Bundesliga | germany_-_bundesliga | Sí | — |
| Serie A | italy_-_serie_a | Sí | — |
| Ligue 1 | france_-_ligue_1 | Sí | — |
| MLS | usa_-_major_league_soccer | Sí | Sí |
| Champions League | uefa_-_champions_league | Sí | Sí |
| Europa League | uefa_-_europa_league | Sí | Sí |
- Las filas
consensusllevan bet % y handle % para el moneyline a tres vías (local, empate, visitante) y para el total de goles (over/under). No llevan spread. - Las filas
draftkingsllevan el split de moneyline de DraftKings solo entre los dos equipos. DraftKings no muestra empate en sus splits de fútbol, así que estas filas son de dos vías ("outcomes": 2, sindraw): no son un split 1X2. No llevan spread ni total.
Parámetros de ConsultaEnlace permanente a esta sección
| Parámetro | Tipo | Descripción |
|---|---|---|
sport | string | Filtra por deporte (separado por comas). Ejemplo: basketball. Solo IDs de deporte; un ID de liga como nba va en league (detalles). |
league | string | Filtra por liga (separado por comas). Ejemplo: nba,ncaab. Los IDs de liga de fútbol figuran arriba en Cobertura de fútbol, p. ej. england_-_premier_league. |
sportsbook | string | Filtra por fuente de splits. Ejemplo: draftkings,circa. También acepta el valor sintético consensus. |
event_id | string | Filtra por ID canónico de evento (separado por comas) |
market | string | Filtra eventos que incluyan un mercado de splits dado (separado por comas). Uno o más de spread, total, moneyline. |
limit | integer | Resultados máximos (predeterminado 100, máximo 200) |
offset | integer | Desplazamiento de paginación (predeterminado 0) |
RespuestaEnlace permanente a esta sección
{
"data": [
{
"event_id": "mlb_guardians_orioles_2026-04-16",
"sport": "baseball",
"league": "mlb",
"sportsbook": "draftkings",
"away_team": "Baltimore Orioles",
"home_team": "Cleveland Guardians",
"spread": {
"away_line": -1.5,
"home_line": 1.5,
"away_odds": -1.5,
"home_odds": 1.5,
"handle_pct": { "away": 0.22, "home": 0.78 },
"bets_pct": { "away": 0.20, "home": 0.80 },
"updated_at": "2026-04-16T19:12:40.118204+00:00"
},
"total": {
"line": 8,
"handle_pct": { "over": 0.53, "under": 0.47 },
"bets_pct": { "over": 0.57, "under": 0.43 },
"updated_at": "2026-04-16T19:20:02.553917+00:00"
},
"moneyline": {
"outcomes": 2,
"away_odds": 104,
"home_odds": -126,
"handle_pct": { "away": 0.28, "home": 0.72 },
"bets_pct": { "away": 0.33, "home": 0.67 },
"updated_at": "2026-04-16T13:48:51.640275+00:00"
},
"fetched_at": "2026-04-16T19:25:28.363825+00:00",
"available_metrics": ["bets_pct", "handle_pct"]
}
],
"pagination": {
"limit": 100,
"offset": 0,
"count": 1,
"total": 41,
"has_more": false,
"next_offset": null
},
"updated_at": "2026-04-16T19:29:38.920698424Z"
}Lee la línea del spread (el hándicap, p. ej., -1.5 / +1.5) en spread.away_line / spread.home_line, los mismos nombres que usa el endpoint histórico. spread.away_odds / spread.home_odds llevan el mismo valor como alias heredado: son la línea, nunca un precio. Ninguna fuente de splits publica un precio de spread.
Campos de RespuestaEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
event_id | string | ID canónico de evento — úsalo para hacer join con los datos de /odds |
sport | string | Nombre de deporte normalizado por Atlas |
league | string | Nombre de liga normalizado por Atlas |
sportsbook | string | Casa de apuestas fuente de los datos de splits (draftkings, circa, betmgm o el valor sintético consensus) |
away_team | string | Nombre del equipo visitante |
home_team | string | Nombre del equipo local |
spread.away_line | number | Línea del spread visitante (p. ej., -1.5) |
spread.home_line | number | Línea del spread local (p. ej., +1.5) |
spread.away_odds | number | Alias heredado: el mismo valor que spread.away_line (la línea, no un precio) — consulta el aviso anterior |
spread.home_odds | number | Alias heredado: el mismo valor que spread.home_line (la línea, no un precio) |
spread.handle_pct | object | % de dinero en cada lado (away, home; 0.0-1.0) |
spread.bets_pct | object | % de tickets en cada lado (away, home; 0.0-1.0) |
total.line | number | Línea de over/under (p. ej., 225.5; en fútbol, total de goles, p. ej., 2.5) |
total.handle_pct | object | % de dinero (over, under; 0.0-1.0) |
total.bets_pct | object | % de tickets (over, under; 0.0-1.0) |
moneyline.outcomes | integer | Cuántos resultados tiene el mercado de moneyline: 3 para un mercado a tres vías (local/empate/visitante), 2 para cualquier otro moneyline. En todo objeto de moneyline — consulta Moneyline a tres vías más abajo |
moneyline.away_odds | number | Cuotas de moneyline del visitante (formato americano) |
moneyline.home_odds | number | Cuotas de moneyline del local (formato americano) |
moneyline.draw_odds | number | Cuotas del empate (formato americano). Solo cuando outcomes es 3 |
moneyline.handle_pct | object | % de dinero en cada lado (away, home y draw cuando outcomes es 3; 0.0-1.0) |
moneyline.bets_pct | object | % de tickets en cada lado (away, home y draw cuando outcomes es 3; 0.0-1.0) |
spread.updated_at, total.updated_at, moneyline.updated_at | string | Cuándo cambiaron por última vez los números de ese mercado (ISO 8601): normalmente la hora en que SharpAPI vio por primera vez los números nuevos, por lo general pocos minutos después del cambio, o, en algunas fuentes, la hora del cambio que indica la propia fuente. null o ausente cuando no se conoce la hora del cambio, por ejemplo cuando el mercado no tiene números; consulta Frescura más abajo |
fetched_at | string | Cuándo consultó SharpAPI por última vez la fuente para esta fila (ISO 8601). Avanza en cada consulta, aunque los números de la fuente no hayan cambiado, así que no indica lo actuales que son: lee updated_at en cada mercado; consulta Frescura más abajo |
available_metrics | array | Qué métricas de split llega a publicar la casa de apuestas de esta fila — bets_pct, handle_pct o ambas, siempre en ese orden. Es una afirmación sobre la casa, no sobre los valores de esta fila. Se omite cuando la casa no está declarada — véase más abajo. |
event_uuid | string | El UUID estable del evento, el mismo valor que event_uuid en /odds. Solo está presente cuando la fila corresponde a exactamente un evento — véase más abajo. |
canonical_event_id | string | El ID del evento correspondiente, tal como lo sirve /events en id y /odds en event_id. Suele ser idéntico a event_id. Solo está presente cuando lo está event_uuid. |
event_start_time | string | La hora de inicio del evento correspondiente (ISO 8601), el mismo valor que start_time en /events. Las filas de /odds llevan el mismo inicio en event_start_time, pero no siempre con el mismo formato (puede omitir los segundos), así que compara ambos como marcas de tiempo, no como cadenas. Solo está presente cuando la fila corresponde a exactamente un evento — véase más abajo. |
exchanges | object | Flujo comprador en exchanges de mercados de predicción para este partido. No es un split de apuestas. Solo está presente cuando un exchange muestra flujo comprador para el partido; si no, falta — consulta Flujo comprador en exchanges más abajo. |
Qué valores pueden ser null, y cuáles pueden faltar. Las claves de porcentaje y las claves de cuotas de la línea de dinero anteriores siempre están presentes (draw y draw_odds solo en un moneyline a tres vías), aunque algunas llevan null en lugar de un número. Otras claves pueden faltar en vez de llevar null: total.line se omite en un evento para el que la casa no ha publicado un total, spread.away_line / .home_line y sus alias spread.away_odds / .home_odds se omiten en una fila betmgm sin línea de spread, y available_metrics se omite para una casa que SharpAPI no ha declarado — léelas con un valor por defecto en lugar de dar por hecho que la clave existe.
handle_pct.away / .home (y .over / .under en los totales) son null en todas las filas betmgm, porque BetMGM solo publica un porcentaje de tickets — no hay cifra de handle que informar. Los valores de bets_pct son null cuando la fuente aún no ha publicado un porcentaje para ese mercado; el feed de BetMGM es intermitente, así que ahí es donde aparece. moneyline.away_odds / .home_odds son null cuando una casa ha retirado la línea de dinero de un evento pero sigue publicando sus porcentajes de splits — esto también ocurre en filas de DraftKings y Circa, no solo de BetMGM. La especificación OpenAPI declara todo esto como nullable, de modo que un cliente generado los aceptará. spread.away_line / .home_line (y spread.away_odds / .home_odds) son null cuando la fuente no ha publicado una línea de spread para el partido, y los valores de bets_pct y handle_pct de ese spread también son null. En un moneyline a tres vías, draw_odds también puede ser null, y cada objeto de porcentajes contiene o tres números o tres null. Una fila de fútbol no lleva spread: todos los campos de spread son null.
event_uuid, canonical_event_id y event_start_time solo están presentes cuando la fila corresponde a exactamente un evento. SharpAPI hace corresponder el event_id de cada fila con un evento. Cuando la correspondencia es ambigua, la fila omite las tres claves en lugar de adivinar: por ejemplo, una fila de doubleheader cuyo event_id no lleva el sufijo _bN podría ser cualquiera de los dos partidos. Una fila cuyo evento no se encuentra también las omite. Además, event_start_time puede faltar en un evento correspondido que no tiene hora de inicio registrada, el mismo caso en el que /events omite start_time. Lee estas claves con un valor por defecto.
El campo event_id utiliza el mismo formato de ID canónico que el endpoint /odds, por lo que puedes hacer join de splits con datos de cuotas directamente.
Por ejemplo, obtén las cuotas de un partido específico y compáralas con sus splits:
GET /api/v1/odds?event_id=nba_thunder_timberwolves_2026-03-15
GET /api/v1/splits?event_id=nba_thunder_timberwolves_2026-03-15/odds no incluye el bet % público por fila.
Los splits de apuestas (% de dinero y % de tickets) solo están disponibles a través de este endpoint (/splits) y su versión histórica (/splits/history). No existe el campo public_bet_pct en las filas de /odds.
Frescura (updated_at)Enlace permanente a esta sección
fetched_at es cuándo SharpAPI consultó por última vez la fuente para la fila. Avanza en cada consulta, aunque la fuente haya dejado de cambiar sus números, así que un fetched_at reciente no significa que los números estén al día. Para saber lo actuales que son, lee updated_at en cada mercado: es cuándo cambiaron por última vez los números de ese mercado. Normalmente es la hora en que SharpAPI vio por primera vez los números nuevos, por lo general pocos minutos después del cambio; en algunas fuentes es la hora del cambio que indica la propia fuente. Compáralo con la hora de tu solicitud para obtener la antigüedad.
En el ejemplo de arriba, fetched_at es cuatro minutos anterior a la respuesta, pero el moneyline cambió por última vez a las 13:48, más de cinco horas antes.
Un mercado cuyo updated_at es null o falta tiene una antigüedad desconocida. Interprétalo como antigüedad desconocida, no como al día.
Las filas se sirven sea cual sea la antigüedad de sus números. updated_at no dice por qué los números no han cambiado: una fuente que ha dejado de actualizarse y un split que se ha mantenido estable se ven igual.
Moneyline a tres vías (outcomes)Enlace permanente a esta sección
Todo objeto moneyline lleva outcomes, el número de resultados que tiene su mercado. Basa tu lógica en outcomes, no en el deporte: un moneyline de fútbol también puede ser de dos vías (consulta la fila de DraftKings más abajo).
outcomes | Mercado | Claves en bets_pct / handle_pct | Precios |
|---|---|---|---|
3 | Local / empate / visitante (1X2): filas consensus de fútbol | away, home, draw | away_odds, home_odds, draw_odds |
2 | Cualquier otro moneyline, incluidas las filas de fútbol de DraftKings | away, home | away_odds, home_odds |
Los tres porcentajes de un objeto a tres vías suman 1, salvo redondeo: en el ejemplo de abajo, los porcentajes de dinero suman 0.99. Un objeto de porcentajes a tres vías se sirve completo o no se sirve. Cuando falta cualquiera de sus porcentajes, o los tres no suman 1 con una tolerancia de 0.02, se sirve como { "away": null, "home": null, "draw": null } y outcomes sigue siendo 3. Nunca se reduce a dos números, así que un moneyline con dos porcentajes nunca es un split 1X2. El bloque exchanges no lleva outcomes.
Una fila consensus de fútbol, a tres vías:
{
"event_id": "germany_-_bundesliga_eintrachtfrankfurt_hoffenheim_2026-11-21_b2",
"sport": "soccer",
"league": "germany_-_bundesliga",
"sportsbook": "consensus",
"away_team": "TSG Hoffenheim",
"home_team": "Eintracht Frankfurt",
"spread": {
"away_line": null,
"home_line": null,
"away_odds": null,
"home_odds": null,
"handle_pct": { "away": null, "home": null },
"bets_pct": { "away": null, "home": null }
},
"total": {
"line": 3.5,
"handle_pct": { "over": 0.90, "under": 0.10 },
"bets_pct": { "over": 0.90, "under": 0.10 }
},
"moneyline": {
"outcomes": 3,
"away_odds": 160,
"home_odds": 128,
"draw_odds": 290,
"handle_pct": { "away": 0.15, "home": 0.70, "draw": 0.14 },
"bets_pct": { "away": 0.24, "home": 0.69, "draw": 0.07 }
},
"fetched_at": "2026-11-20T22:32:18.402771+00:00",
"available_metrics": ["bets_pct", "handle_pct"]
}Una fila de fútbol de DraftKings, a dos vías (aquí se omiten su spread y su total):
{
"event_id": "uefa_-_champions_league_astonvilla_galatasaray_2026-11-24_b2",
"sport": "soccer",
"league": "uefa_-_champions_league",
"sportsbook": "draftkings",
"away_team": "Aston Villa",
"home_team": "Galatasaray",
"moneyline": {
"outcomes": 2,
"away_odds": 145,
"home_odds": 155,
"handle_pct": { "away": 0.62, "home": 0.38 },
"bets_pct": { "away": 0.82, "home": 0.18 }
}
}DraftKings muestra su split de fútbol solo para los dos equipos. away_odds y home_odds son sus precios para la victoria de cada equipo, y los dos porcentajes de bets_pct y los dos de handle_pct suman 1 en cada caso. No es un split 1X2: no compares sus dos porcentajes uno a uno con los tres porcentajes de una fila consensus. Todos los campos de spread y total de estas filas son null: el split de fútbol de DraftKings solo cubre el moneyline.
Cómo leer available_metricsEnlace permanente a esta sección
Una fila de splits puede incluir available_metrics, un array que nombra las métricas de split que la casa de apuestas de esa fila llega a publicar. Describe la casa, no la fila: una casa que publica el porcentaje de dinero sigue listando handle_pct aunque los miembros handle_pct de esa fila sean null.
Solo pueden aparecer dos nombres, siempre en este orden, y cada uno es exactamente una clave dentro de los objetos spread, total y moneyline, de modo que un nombre aquí apunta a un campo que puede consultar:
bets_pct— porcentaje de tickets (apuestas realizadas), 0.0-1.0handle_pct— porcentaje de dinero (handle), 0.0-1.0
El campo se omite por completo cuando SharpAPI no ha declarado qué publica una casa. Su ausencia significa no declarado, nunca no publica nada.
Lea la lista junto con el valor. Tomando handle_pct como ejemplo:
available_metrics | Miembros de handle_pct | Qué significa |
|---|---|---|
presente, lista handle_pct | números | La casa publica el porcentaje de dinero y lo tenemos. |
presente, lista handle_pct | null | La casa publica el porcentaje de dinero y nos falta — una carencia de nuestro lado, no una limitación de la casa. |
presente, no lista handle_pct | null | La casa no publica el porcentaje de dinero. No hay nada roto. |
presente, no lista handle_pct | números | No debería ocurrir; trátelo como una declaración desactualizada y confíe en el valor. |
| ausente | números o null | No se declara nada sobre esta casa. No deduzca en ningún sentido — lea los valores por sí mismos y no registre la casa como que no publica nada. |
Una fila consensus fusionada lleva la intersección. Una fila fusionada con "sportsbook": "consensus" agrupa varias casas, así que su afirmación debe cumplirse para todas ellas: lista solo las métricas que declaran todas las casas contribuyentes, y omite el campo por completo si alguna de ellas no está declarada.
Flujo comprador en exchanges (exchanges)Enlace permanente a esta sección
Una fila puede incluir un objeto exchanges: el flujo comprador del mismo partido en exchanges de mercados de predicción. Muestra qué lado tomaron los compradores en cada exchange, como porcentaje del dinero y como porcentaje de las operaciones. No es un split de apuestas: no procede de ninguna casa de apuestas, no lleva el campo sportsbook y nunca es una fila propia.
El objeto solo está presente cuando al menos un exchange muestra flujo comprador para el partido, y falta en caso contrario, así que léelo con un valor por defecto. Cuando un evento tiene más de una fila (casas que no coinciden), cada fila de ese evento lleva el mismo objeto exchanges.
{
"event_id": "nba_celtics_knicks_2026-11-02",
"sportsbook": "consensus",
"exchanges": {
"fetched_at": "2026-11-02T12:00:01+00:00",
"moneyline": [
{
"exchange": "kalshi",
"line": null,
"money_pct": { "away": 0.06, "home": 0.94 },
"trades_pct": { "away": 0.61, "home": 0.39 },
"usd_traded": 2759,
"trade_count": 41,
"light_trading": true,
"all_lines": false,
"updated_at": "2026-11-02T11:59:00+00:00"
}
],
"spread": [
{
"exchange": "kalshi",
"line": { "away": -3.5, "home": 3.5 },
"money_pct": { "away": 0.55, "home": 0.45 },
"trades_pct": { "away": 0.48, "home": 0.52 },
"usd_traded": 18420.5,
"trade_count": 212,
"light_trading": false,
"all_lines": false,
"updated_at": "2026-11-02T11:59:00+00:00"
}
],
"total": [
{
"exchange": "prophetx",
"line": 221.5,
"money_pct": { "over": 0.7, "under": 0.3 },
"trades_pct": { "over": null, "under": null },
"usd_traded": null,
"trade_count": null,
"light_trading": false,
"all_lines": true,
"updated_at": "2026-11-02T11:58:30+00:00"
}
]
}
}El resto de campos de la fila son los del ejemplo de respuesta de arriba.
| Campo | Tipo | Descripción |
|---|---|---|
exchanges.fetched_at | string | Cuándo se leyó el flujo de los exchanges para este partido (ISO 8601) |
exchanges.moneyline / .spread / .total | array | Una entrada por cada exchange que muestra flujo en ese mercado. Un mercado sin entradas se omite. |
exchange | string | El exchange: kalshi, polymarket, novig o prophetx |
line | number, object o null | La línea a la que corresponde el flujo. Siempre null en moneyline. Un número en total (p. ej. 221.5). Un objeto con away y home en spread (p. ej. -3.5 / 3.5). También null cuando no se conoce la línea del exchange. |
money_pct | object | Porcentaje del dinero que compró cada lado (0.0-1.0). Las claves son away / home en moneyline y spread, over / under en total. Ambos miembros son números. |
trades_pct | object | Porcentaje de las operaciones que compraron cada lado (0.0-1.0), con las mismas claves que money_pct. Ambos miembros son null cuando el exchange no informa del reparto de operaciones; nunca es null uno sin el otro. |
usd_traded | number o null | Dinero negociado, en dólares estadounidenses. null cuando no se informa. |
trade_count | integer o null | Número de operaciones. null cuando no se informa. |
light_trading | boolean | true cuando la muestra es escasa: la entrada se muestra, pero no te apoyes en sus porcentajes. |
all_lines | boolean | true cuando el volumen se agrupa en todas las líneas de ese mercado en el exchange, no solo en la línea que muestra line. |
updated_at | string | Cuándo se tomó la lectura de este exchange (ISO 8601). Úsalo para saber qué antigüedad tiene la lectura. |
Los porcentajes de los exchanges son fracciones de 0 a 1, la misma escala que los campos de split. money_pct y trades_pct se leen como handle_pct y bets_pct: 0.94 significa 94 %. El bloque solo informa del flujo comprador; no incluye interés abierto (open interest).
EjemplosEnlace permanente a esta sección
Todos los Splits NBA
curl "https://api.sharpapi.io/api/v1/splits?league=nba" \
-H "X-API-Key: YOUR_API_KEY"Historial de SplitsEnlace permanente a esta sección
Realiza un seguimiento de cómo cambian los splits a lo largo del tiempo para un evento concreto.
GET /api/v1/splits/history?event_id={event_id}Parámetros de ConsultaEnlace permanente a esta sección
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
event_id | string | Sí | ID canónico de evento |
sportsbook | string | No | Filtra por casa (separadas por comas), antes de paginar. |
start_time | string | No | Límite inferior. RFC 3339 (2026-04-16T13:00:00Z) o segundos Unix (1776344602). |
end_time | string | No | Límite superior, mismos formatos. |
limit | integer | No | Entradas máximas (predeterminado 100, máximo 200). |
cursor | string | No | Token de continuación de meta.next_cursor; conserva los filtros de evento, casa y tiempo. |
La retención es de solo 48 horas. No hay archivo a largo plazo ni recuperación de muestras fuera de esa ventana. Sigue meta.next_cursor mientras meta.has_more sea true. meta.total, books, oldest y newest describen la página actual; meta.limit es el tamaño efectivo (100 por defecto, máximo 200; los valores mayores se limitan a 200). Mantén el mismo end_time en todas las páginas para un intervalo fijo. Las fechas no válidas o los cursores incompatibles devuelven 400; los fallos temporales del almacén devuelven 503.
RespuestaEnlace permanente a esta sección
Las entradas se ordenan de la más antigua a la más reciente. Este endpoint emite el envoltorio de éxito (success/data/meta) — distinto de /splits, que emite data/pagination/updated_at.
El payload del historial usa book (no sportsbook), una inconsistencia conocida frente a /splits. Su spread incluye away_line/home_line, igual que /splits, pero no el alias heredado away_odds/home_odds. Cada entrada incluye además available_metrics, con el mismo significado que en /splits: las métricas que llega a publicar la casa de esa entrada. Se omite para una casa que SharpAPI no ha declarado.
El moneyline de cada entrada tiene la misma forma que en /splits: outcomes en todo objeto de moneyline, y draw y draw_odds en una entrada a tres vías. Las entradas de fútbol a tres vías son entradas consensus ("book": "consensus").
Los valores del historial pueden no estar disponibles. Los porcentajes pueden ser null; BetMGM nunca publica porcentajes de dinero. Las líneas y cuotas pueden faltar o ser null. Consulta available_metrics para saber qué métricas publica la casa y comprueba los valores ausentes o nulos de cada mercado.
{
"success": true,
"data": [
{
"available_metrics": ["bets_pct", "handle_pct"],
"book": "circa",
"ts": "2026-04-16T13:03:21.071966+00:00",
"timestamp": 1776344602.36,
"spread": {
"away_line": -1.5,
"home_line": 1.5,
"handle_pct": { "away": 0.37, "home": 0.63 },
"bets_pct": { "away": 0.27, "home": 0.73 }
},
"total": {
"line": 8,
"handle_pct": { "over": 0.43, "under": 0.57 },
"bets_pct": { "over": 0.55, "under": 0.45 }
},
"moneyline": {
"outcomes": 2,
"away_odds": 104,
"home_odds": -126,
"handle_pct": { "away": 0.35, "home": 0.65 },
"bets_pct": { "away": 0.35, "home": 0.65 }
}
}
],
"meta": {
"event_id": "mlb_guardians_orioles_2026-04-16",
"total": 1,
"books": ["circa"],
"limit": 100,
"has_more": false,
"next_cursor": "",
"oldest": "2026-04-16T13:03:22.360588312Z",
"newest": "2026-04-16T13:03:22.360588312Z",
"updated_at": "2026-04-16T19:28:50.525875452Z"
}
}Los datos se recopilan cada ~5 minutos y se conservan durante 48 horas mediante un sorted set de Valkey (splits_history:{event_id}) puntuado por timestamp Unix.
Historial Completo
curl "https://api.sharpapi.io/api/v1/splits/history?event_id=nba_thunder_timberwolves_2026-03-15" \
-H "X-API-Key: YOUR_API_KEY"Interpretación de los SplitsEnlace permanente a esta sección
| Señal | Qué significa |
|---|---|
| Bet % alto, Handle % bajo | Lado público — muchas apuestas pequeñas |
| Bet % bajo, Handle % alto | Lado sharp — menos apuestas pero más grandes |
| DK y Circa coinciden | Consenso de mercado — público y sharp alineados |
| DK y Circa divergen | Brecha sharp-público — Circa (sharp) discrepa de DK (público) |
Los splits de casas de apuestas provienen únicamente de tres casas — DraftKings y BetMGM (recreativas) y Circa (cercana al perfil sharp). Las únicas otras filas son las filas consensus (consulta Fuentes de Datos). Ninguna casa verdaderamente sharp publica splits. Utiliza los splits como una señal más junto con el movimiento de líneas y el análisis de +EV, no de forma aislada.