Skip to Content
Referencia de la APIInstantánea de cuotas

Instantánea de Cuotas

Obtén una instantánea de las cuotas actuales de las casas de apuestas.

GET /api/v1/odds

Cambio en v3.0.0: los antiguos campos odds_changed_at, last_seen_at y wire_received_at se han eliminado — usa timestamp (entrega / frescura del feed) en su lugar. Desde noviembre de 2026, price_updated_at indica cuándo se movió el precio por última vez.

AutenticaciónEnlace permanente a esta sección

Requiere API key. Disponible para todos los planes.

Las casas de apuestas devueltas en tus resultados dependen de tu plan de suscripción. Los usuarios del plan Free reciben cuotas únicamente de DraftKings y FanDuel. Consulta Acceso a Casas por Plan más abajo.

Parámetros de ConsultaEnlace permanente a esta sección

ParámetroTipoPredeterminadoDescripción
sportsbookstringpermitidas por planIDs de casas de apuestas separados por comas (p. ej., draftkings,fanduel). Se aplican los límites del plan.
sportstringtodosFiltrar por deporte(s), separados por comas (p. ej., basketball, football). Admite alias de categoría. Solo IDs de deporte; un ID de liga como nba va en league (detalles).
leaguestringtodasFiltrar por liga(s), separadas por comas (p. ej., nba, nfl, nhl)
marketstringtodosFiltrar por tipo(s) de mercado, separados por comas. Admite alias de categoría (main, spread, total, props) o tipos exactos (point_spread, player_points).
event_idstring—Filtrar por ID(s) de evento, separados por comas
is_liveboolean—true = solo en directo, false = solo prepartido, omitir = ambos
min_oddsnumber—Filtro de cuotas americanas mínimas (p. ej., -110)
max_oddsnumber—Filtro de cuotas americanas máximas (p. ej., +200)
group_bystring—Agrupar resultados por campo (p. ej., event)
statestring—Código de estado de EE. UU. solo para el destino del enlace; no filtra cuotas ni devuelve precios específicos por estado. Acepta los 50 códigos de estados de EE. UU. y dc; los códigos no vacíos no admitidos (incluido on) devuelven 400 invalid_filter. Cuando se establece, las URLs deep_link incluyen ?state=XX; los valores omitidos o vacíos no generan ?state=, y la redirección aplica entonces su propio valor por defecto pa. Solo afecta a las casas con URLs dependientes del estado (BetMGM, Caesars, BetRivers).
limitinteger50Máximo de resultados por página (máx. 200)
offsetinteger0Desplazamiento de paginación. Debe ser ≤ 500. Los valores superiores a 500 devuelven 400 offset_too_large — usa cursor para una paginación más profunda. Puede producir filas duplicadas cuando los datos en directo se actualizan entre solicitudes.
cursorstring—Cursor opaco de next_cursor en una respuesta anterior. Obligatorio para paginación profunda (más allá del offset 500) y recomendado para cualquier escaneo de varias páginas — estable frente a cambios en datos en directo. Tiene prioridad sobre offset cuando se proporcionan ambos.

Usa valores separados por comas para filtrar por varias casas de apuestas: sportsbook=draftkings,fanduel,betmgm

Alias de Categoría de MercadoEnlace permanente a esta sección

En lugar de listar tipos de mercado individuales, puedes usar un alias de categoría para coincidir con un grupo de mercados relacionados. Los alias y los tipos exactos pueden mezclarse libremente en una lista separada por comas.

AliasSe expande a
mainmoneyline, point_spread, total_points
spreadpoint_spread, puck_line, run_line, set_handicap
totaltotal_points, total_goals, total_runs, total_games, total_rounds, team_total
propsTodos los tipos de mercado player_* (coincidencia por prefijo)
# Obtener todos los mercados "main" (moneyline + spreads + totales) curl "https://api.sharpapi.io/api/v1/odds?league=nba&market=main" \ -H "X-API-Key: YOUR_API_KEY" # Mezclar un alias con un tipo exacto curl "https://api.sharpapi.io/api/v1/odds?league=nfl&market=spread,moneyline" \ -H "X-API-Key: YOUR_API_KEY" # Todos los mercados de player props curl "https://api.sharpapi.io/api/v1/odds?league=nba&market=props" \ -H "X-API-Key: YOUR_API_KEY"

El alias props utiliza una coincidencia por prefijo, por lo que incluye automáticamente cualquier tipo de mercado que comience con player_ (p. ej., player_points, player_rebounds, player_assists, player_strikeouts, etc.).

Ejemplos de SolicitudesEnlace permanente a esta sección

curl -X GET "https://api.sharpapi.io/api/v1/odds?league=nba&sportsbook=draftkings&market=moneyline" \ -H "X-API-Key: YOUR_API_KEY"

PaginaciónEnlace permanente a esta sección

Usa paginación basada en cursor para escaneos de varias páginas. El endpoint /odds sirve datos en directo que se refrescan cada ~15 segundos. Con paginación basada en offset, las filas pueden cambiar de posición entre solicitudes, causando duplicados en los límites de página. La paginación basada en cursor ancla cada página al último elemento visto — sin desviaciones.

Cada respuesta incluye tanto next_cursor (estable) como next_offset (legacy) en el objeto pagination. Para escaneos secuenciales de un conjunto de datos completo, usa siempre next_cursor.

# Primera página — no se necesita cursor curl "https://api.sharpapi.io/api/v1/odds?league=nfl&limit=200" \ -H "X-API-Key: YOUR_API_KEY" # Páginas siguientes — pasa next_cursor de la respuesta anterior curl "https://api.sharpapi.io/api/v1/odds?league=nfl&limit=200&cursor=eyJlIjoiMzM0ODMxNTMiLCJiIjoiZHJhZnRraW5ncyIsIm0iOiJtb25leWxpbmUiLCJpIjoiZHJhZnRraW5nc18zMzQ4MzE1M19tb25leWxpbmVfUEhJIn0" \ -H "X-API-Key: YOUR_API_KEY"

Orden de los resultadosEnlace permanente a esta sección

Los resultados se devuelven en orden cronológico por hora de inicio del evento: primero los eventos que ya están en curso y los que empiezan antes, después los posteriores. Los eventos sin hora de inicio en el feed se ordenan al final.

Por tanto, una sola página es una porción del calendario, no una muestra del conjunto completo de resultados. Una casa de apuestas sin partidos que empiecen dentro del tramo del calendario que esa página cubre no aparecerá en ella, aunque tenga muchas filas coincidentes más tarde ese mismo día: es el comportamiento esperado, no una falta de cobertura. Para comprobar si una casa ofrece un mercado, filtra con ?sportsbook= o acota con ?league= en lugar de leer una primera página sin filtrar.

En una página con filas, eso es lo que indica meta.books: una casa que aparece en in_scope sin entrada en in_page no devolvió filas en esa página, normalmente porque sus partidos quedan fuera del tramo del calendario que esa página cubre y no porque no ofrezca el mercado.

Los cursores son opacos — no los analices ni los construyas. Codifican la posición de ordenación del último elemento de la página actual y solo son válidos para los mismos parámetros de filtro.

?offset=N sigue funcionando para paginación superficial (hasta el offset 500) y es apropiado para solicitudes de una sola página o acceso directo por posición. Más allá de 500, la API devuelve 400 offset_too_large — de lo contrario, el servidor tendría que ordenar el conjunto de resultados filtrado completo en cada página, lo que es mucho más barato evitar que optimizar por solicitud. Usa cursor para cualquier cosa más profunda.

{ "error": { "code": "offset_too_large", "message": "offset must be <= 500; use `cursor=` from the previous response for deeper pagination", "max_offset": 500 } }

RespuestaEnlace permanente a esta sección

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

{ "success": true, "data": [ { "id": "draftkings_33483153_moneyline_PHO", "sportsbook": "draftkings", "event_id": "33483153", "sport": "basketball", "league": "nba", "home_team": "PHI 76ers", "away_team": "PHO Suns", "market_type": "moneyline", "selection": "PHO Suns", "selection_type": "away", "odds_american": -150, "odds_decimal": 1.667, "odds_probability": 0.60, "line": null, "event_start_time": "2026-01-26T19:00:00Z", "timestamp": "2026-01-26T02:10:24.125Z", "price_updated_at": "2026-01-26T01:52:41.380Z", "is_live": false }, { "id": "draftkings_33483153_moneyline_PHI", "sportsbook": "draftkings", "event_id": "33483153", "sport": "basketball", "league": "nba", "home_team": "PHI 76ers", "away_team": "PHO Suns", "market_type": "moneyline", "selection": "PHI 76ers", "selection_type": "home", "odds_american": 130, "odds_decimal": 2.30, "odds_probability": 0.4348, "line": null, "event_start_time": "2026-01-26T19:00:00Z", "timestamp": "2026-01-26T02:10:24.125Z", "price_updated_at": "2026-01-26T01:52:41.380Z", "is_live": false } ], "meta": { "count": 2, "total": 3095, "books_available": ["draftkings", "fanduel", "betmgm", "caesars", "pinnacle"], "books_returned": ["draftkings"], "pagination": { "limit": 50, "offset": 0, "has_more": true, "next_offset": 50, "next_cursor": "eyJlIjoiMzM0ODMxNTMiLCJiIjoiZHJhZnRraW5ncyIsIm0iOiJtb25leWxpbmUiLCJpIjoiZHJhZnRraW5nc18zMzQ4MzE1M19tb25leWxpbmVfUEhJIn0" }, "updated_at": "2026-01-26T02:10:37.846Z", "filters": { "league": "nba", "sportsbook": "draftkings", "market": "moneyline" } } }

Resultados vacíos (200): meta.storeEnlace permanente a esta sección

Una página vacía —200 con "data": [] y "count": 0— puede significar dos cosas distintas: que tus filtros no coincidieron con nada, o que la instancia que respondió no tenía nada cargado en ese momento (por ejemplo, durante un cambio de store). Desde septiembre de 2026 la respuesta indica cuál de las dos es. Siempre que /odds devuelve cero filas añade un bloque meta.store, y reason es el campo sobre el que debes decidir:

{ "data": [], "pagination": { "limit": 50, "offset": 0, "count": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-09-07T02:41:18.552Z", "meta": { "store": { "generation": 5019, "ready": true, "books": 39, "rows": 810137, "reason": "no_match" } } }
reasonSignificadoQué hacer
warmingLa instancia que respondió no ha completado ningún ciclo de actualización desde su último cambio de modo: todavía no hay nada cargadoReintentar
store_emptyLa instancia está lista pero no contiene ninguna fila de cuotas, por ejemplo en mitad de un cambio de storeReintentar; no trates la página vacía como definitiva
no_matchLa instancia está lista y con datos; tus filtros no coincidieron con nadaDefinitivo: reintentar no cambiará la respuesta
CampoTipoSignificado
generationintegerGeneración del snapshot desde la que se sirvió esta respuesta. 0 significa que no se ha cargado nada desde el arranque del proceso.
readybooleanSe ha completado al menos un ciclo de actualización desde el último cambio de modo de la instancia.
booksintegerCasas de apuestas presentes en el snapshot desde el que se sirvió esta respuesta, independientemente de tus filtros.
rowsintegerFilas de cuotas contenidas en ese snapshot, independientemente de tus filtros.
reasonstringwarming, store_empty o no_match; ver arriba.
event_statusstringPresente solo cuando la página está vacía porque el único evento por el que filtraste con event_id ha terminado: final (se conserva un resultado finalizado; el mismo registro que /events/{eventId} sirve como status: "final") o gone (el evento salió del calendario en aproximadamente la última hora sin un resultado finalizado; la misma condición bajo la que /events/{eventId} responde 410 Gone). Omitido en cualquier otro caso. Ver Eventos finalizados más abajo.
completed_atstringAcompaña únicamente a event_status: "final": el instante RFC 3339 en que se detectó la finalización, idéntico al completed_at de /events/{eventId}. Nunca se envía con gone.
  • Solo está presente en resultados vacíos. Una respuesta con filas es idéntica byte a byte a la anterior y no incluye meta.store; los parsers que leen data + pagination + updated_at siguen funcionando.
  • books y rows describen el snapshot completo, no tu consulta: rows: 810137 demuestra que el store tenía datos, no cuenta lo que habrías obtenido.
  • Las consultas que se resuelven a dos o más casas de apuestas también incluyen meta.books (el conjunto de casas resuelto: in_scope y los recuentos in_page por casa); meta.store se añade junto a él. Lo mismo ocurre con la página vacía de una selección de casas del dashboard que no se resolvió a ninguna casa; ver Selección de casas vacía más abajo.
  • Un valor desconocido de league o sportsbook se rechaza con 400 invalid_filter en lugar de responderse con una página vacía. Los demás filtros no se validan contra el catálogo: un market_type o un event_id que no existe en ningún sitio devuelve una página vacía normal con reason: "no_match".

Eventos finalizados: event_status y completed_atEnlace permanente a esta sección

Un cliente que sigue consultando /odds?event_id=<id> después de que el partido termine recibe una página vacía definitiva: reason: "no_match" es cierto, pero no dice por qué nada coincidió. Cuando la página está vacía porque el único evento por el que filtraste ha terminado, meta.store también lo indica. Esta es la respuesta real para un partido de la MLB que había terminado esa misma noche (una consulta de una sola casa, para que el cuerpo sea corto; una consulta de varias casas incluye además meta.books, como arriba):

GET /api/v1/odds?event_id=mlb_twins_whitesox_2026-09-06_b3&sportsbook=pinnacle&limit=1
{ "data": [], "pagination": { "limit": 1, "offset": 0, "count": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-09-07T10:04:34.951684418Z", "meta": { "store": { "generation": 13456, "ready": true, "books": 39, "rows": 947879, "reason": "no_match", "event_status": "final", "completed_at": "2026-09-07T02:09:37Z" } } }

/events/mlb_twins_whitesox_2026-09-06_b3 devolvió en ese mismo instante status: "final" con el mismo completed_at: ambos endpoints leen el mismo registro, así que no pueden discrepar.

event_statusSignificadoQué hacer
finalSe conserva un resultado finalizado para el evento; completed_at es el momento en que se detectó.Deja de consultar: el evento ha terminado; obtén el resultado en /events/{eventId}
goneEl evento salió del calendario en aproximadamente la última hora sin un resultado finalizado: aplazado, cancelado o terminado tan recientemente que aún no se ha registrado ningún resultado. Es la misma condición bajo la que /events/{eventId} responde 410 Gone, y no afirma que el evento haya terminado.Deja de consultar las cuotas; comprueba /events/{eventId} más tarde para ver si hay resultado

La señal solo se añade cuando se cumplen todas las condiciones siguientes; en caso contrario el bloque conserva su forma habitual y ninguna de las dos claves está presente:

  • la petición filtró por exactamente un event_id (una lista separada por comas no recibe señal; el campo es singular);
  • la página está vacía con reason: "no_match" (una página warming o store_empty nunca la incluye: el vacío es del store, y reason ya indica que reintentes);
  • se sabe que el evento ha terminado. Un evento todavía en vivo o próximo, o un id que no existe en ningún sitio, recibe un no_match normal sin event_status; así que una consulta de un solo id respondida sin él significa un id incorrecto o un evento que no ha terminado.

Un evento finalizado cuyas cuotas siguen en caché devuelve esas filas con normalidad; la señal aparece cuando la página se vacía. completed_at es el momento en que se detectó la finalización —normalmente unos minutos después de que el evento saliera del feed en vivo—, no el pitido final; la misma salvedad que completed_at en /events. El código de estado nunca cambia: un cliente que consulta un evento durante toda su vida sigue recibiendo 200.

Selección de casas vacía: meta.books.reasonEnlace permanente a esta sección

Si la selección de casas de apuestas guardada en tu dashboard no se resuelve a nada —todas las casas seleccionadas están ausentes del snapshot actual o no están incluidas en tu plan—, una petición a /odds sin filtros se responde con una página vacía. El store está bien; la selección es el motivo, y la respuesta lo nombra. meta.books —normalmente presente solo en consultas que se resuelven a dos o más casas— se emite con un conjunto vacío, reason: "selection_disjoint" y selected, la selección que no se resolvió a nada (IDs canónicos de casa, ordenados):

{ "data": [], "pagination": { "limit": 50, "offset": 0, "count": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-09-07T10:04:34.951684418Z", "meta": { "books": { "in_scope": [], "in_page": {}, "reason": "selection_disjoint", "selected": ["betway", "bwin"] }, "store": { "generation": 13454, "ready": true, "books": 39, "rows": 947919, "reason": "no_match" } } }
  • meta.books.reason tiene prioridad. meta.store sigue apareciendo junto a él con reason: "no_match": correcto para el store (tiene datos), pero no es la causa. Cuando meta.books.reason está presente, ese es el motivo de la página vacía; reintentar no cambiará la respuesta. Corrige la selección en tu dashboard, o mejora tu plan si las casas que seleccionaste requieren uno superior.
  • in_scope e in_page están presentes y vacíos ([] / {}, nunca null). El único valor de reason hoy es selection_disjoint.
  • Se emite solo cuando la selección es realmente la causa: la petición no llevaba un filtro sportsbook= explícito, tienes una selección en el dashboard y tu plan por sí solo se habría resuelto al menos a una casa. Nunca aparece en el plan Free (que siempre sirve DraftKings y FanDuel, sea cual sea la selección) ni con un store vacío o en calentamiento: esas páginas las explica meta.store.
  • Con un filtro sportsbook= explícito, la misma discrepancia se rechaza en lugar de responderse con una página vacía: 403 tier_restricted, 403 book_not_selected o 503 book_unavailable.
  • Las páginas que se resuelven a una o más casas no cambian: el bloque de dos o más casas no lleva reason ni selected, y un conjunto de una sola casa no lleva meta.books en absoluto.

Cabeceras de RespuestaEnlace permanente a esta sección

X-RateLimit-Limit: 300 X-RateLimit-Remaining: 299 X-RateLimit-Reset: 1737853200 X-Data-Delay: 0 X-Request-Id: req_abc123def456
CabeceraDescripción
X-RateLimit-LimitMáximo de solicitudes por minuto para tu plan
X-RateLimit-RemainingSolicitudes restantes en la ventana actual
X-RateLimit-ResetMarca de tiempo Unix cuando se restablece el límite de tasa
X-Data-DelayRetraso de datos en segundos (0 para tiempo real, 60 para el plan Free)
X-Request-IdIdentificador único de solicitud para depuración

Respuestas de ErrorEnlace permanente a esta sección

401 No Autorizado

Si no se envía ninguna clave se devuelve missing_api_key; una clave inválida devuelve invalid_api_key.

{ "error": { "code": "missing_api_key", "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.", "docs": "https://docs.sharpapi.io/en/authentication" } }

403 Plan Restringido

Un filtro sportsbook= que nombra un sportsbook por encima de tu plan se rechaza con este cuerpo. Los sportsbooks solicitados, los que tu clave puede consultar y required_tier van en details (este cuerpo no tiene tier en el nivel superior), y upgrade / upgrade_note nombran el plan que los desbloquea (Campos de mejora). Compara code, no el texto de message.

{ "error": { "code": "tier_restricted", "message": "the requested sportsbooks require sharp tier or higher; your current plan is pro. Upgrade to Sharp for $399/mo, with 25 sportsbooks of your choice: https://sharpapi.io/dashboard/billing/upgrade/sharp", "details": { "field": "sportsbook", "requested": ["pinnacle"], "allowed": ["betmgm", "caesars", "draftkings", "fanduel"], "required_tier": "sharp" }, "upgrade": "https://sharpapi.io/dashboard/billing/upgrade/sharp?utm_source=api&utm_medium=403&utm_campaign=sharp-plan-books", "upgrade_note": "Upgrade to Sharp for $399/mo, with 25 sportsbooks of your choice" } }

429 Límite de Tasa Superado

{ "error": { "code": "rate_limited", "message": "Rate limit exceeded. Retry after 45 seconds.", "docs": "https://docs.sharpapi.io/en/authentication#rate-limits" } }

Esquema del Objeto OddsEnlace permanente a esta sección

CampoTipoDescripción
idstringIdentificador único de la cuota
sportsbookstringID de la casa de apuestas (p. ej., draftkings)
event_idstringIdentificador del evento
sportstringSlug del deporte (p. ej., basketball, football)
leaguestringSlug de la liga (p. ej., nba, nfl)
home_teamstringNombre del equipo local
away_teamstringNombre del equipo visitante
market_typestringmoneyline, spread, total, player_prop, etc.
selectionstringLa selección (nombre del equipo, Over/Under, nombre del jugador)
selection_typestringIdentificador canónico del lado. Consulta Tipos de selección más abajo para el enum completo, incluyendo formas compuestas (p. ej. home_over) que se emiten en mercados multieje.
team_sidestring|undefinedPista de lado del equipo en bruto desde el adaptador — uno de home, away, draw. Útil cuando selection_type lleva un valor compuesto (p. ej. home_over) y solo necesitas el eje de equipo sin tener que parsear. Ausente cuando el adaptador no lo selló.
odds_americannumberCuotas americanas (p. ej., -110, +150)
odds_decimalnumberCuotas decimales (p. ej., 1.909)
odds_probabilitynumberProbabilidad implícita (p. ej., 0.5238)
linenumber | nullValor de la línea de spread o total (null para moneyline)
is_alternate_lineboolean|undefinedtrue cuando el line de esta fila difiere de la línea principal propia de esta casa de apuestas para su cohorte — la cohorte es (event, market_type, eje de selección), resuelta por casa de apuestas. La línea principal de una casa es la que ofrece en ambos sentidos y cuyas dos cuotas están más cerca de un mercado parejo; los dos lados de esa línea cuentan como principales. Una casa que no ofrece ninguna línea en ambos sentidos (una escalera de un solo lado) recibe la línea que ofrecen más casas, o su propio escalón mejor clasificado cuando no ofrece esa. Dos casas pueden tener líneas principales distintas en el mismo mercado. Siempre false para mercados sin línea (moneyline, outright). Disponible en /odds y en /opportunities/ev. Úsalo para separar instantáneas de línea principal y líneas alternativas.
event_start_timestringHora de inicio del evento en ISO 8601
timestampstringHora ISO 8601 en que SharpAPI refrescó por última vez esta cuota 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.
price_updated_atstring|undefinedHora ISO 8601 en que se actualizó por última vez el precio de esta cuota. Se mueve cuando cambian el precio, la línea, el estado en vivo o la suspensión, y cuando cambian el libro de órdenes o el tamaño disponible (mejor bid o ask, best_bid_liquidity, total_liquidity, max_bet). No se mueve cuando SharpAPI vuelve a leer una fila sin cambios, así que distingue un precio congelado durante horas de uno que acaba de moverse. Normalmente es la hora en que SharpAPI vio el cambio por primera vez; para unas pocas casas que envían una hora de cambio propia fiable, es la hora de la casa. Se omite cuando la fila no tiene hora de cambio. Consulta Entendiendo el campo timestamp.
is_livebooleanIndica si el precio de esta casa de apuestas está en vivo. Para el estado del propio partido, usa status en /events.
is_player_propbooleantrue en cualquier mercado a nivel de jugador — un precio sobre un único jugador concreto en lugar de sobre un equipo o el partido en conjunto. Además de los tipos canónicos player_* (player_points, player_goals), cubre los mercados de goleador (anytime_goal_scorer, first_goal_scorer, anytime_touchdown_scorer), los mercados de jugador limitados a un periodo o segmento (1st_quarter_player_points, 1st_half_player_goals) y los mercados most_*_player. Los mercados a nivel de competición que solo suenan a superlativo (most_corners) no se marcan. Más amplio que el alias de mercado props, que sigue siendo una coincidencia por prefijo player_. ⚠ selection no tiene la misma forma en todas las filas marcadas: en los tipos player_* lleva el lado (Over, Under, Yes, No), y en el resto de mercados a nivel de jugador lleva la etiqueta de la casa de apuestas, que normalmente nombra al jugador.
event_uuidstring|undefinedUUID canónico estable del evento desde el atlas de SharpAPI, cuando el evento está mapeado. Mientras event_id lleva el identificador principal del adaptador (a menudo el de la casa de apuestas originadora), event_uuid es un hash estable entre feeds que puedes usar para joins entre feeds. Ausente para eventos no mapeados.
external_event_idstring|undefinedEl ID de evento nativo de la propia casa de apuestas, cuando difiere de event_id. Útil para enlazar filas de vuelta a la UI o API de la casa de apuestas.
deep_linkstring|undefinedURL resolutiva que apunta a la página de evento o del cupón de la casa de apuestas. Pasa state= (p. ej. state=nj) en la solicitud para enrutar a subdominios específicos por estado en las casas que los requieren (BetMGM, Caesars, BetRivers).
market_idstring|undefinedIdentificador de mercado nativo de la casa de apuestas. Algunas casas no lo exponen — ausente cuando no se conoce. Su alcance es el de la propia casa: en la mayoría de las casas ambos lados de una línea lo comparten, pero algunas usan un mismo market_id para toda una escalera de líneas, y otras incluyen en él la línea con signo, de modo que los dos lados de un spread llevan ids distintos. Para emparejar los dos lados de una línea, haz coincidir sportsbook, event_id, market_type, player_name en props y la línea (el mismo valor en un total, el signo opuesto en un spread), con el selection_type opuesto; no emparejes solo por market_id.
external_market_idstring|undefinedUn identificador de mercado que es el mismo en todos los estados de EE. UU. en los que opera la casa de apuestas. Presente solo en filas de FanDuel — FanDuel genera una market_id por estado; external_market_id contiene el equivalente independiente del estado. Ausente en todas las demás casas. Al construir un enlace de cupón de FanDuel por tu cuenta, usa external_market_id junto con selection_id — ese par funciona en cualquier estado. Si usas el campo deep_link directamente, no necesitas cambiar nada: los valores deep_link de FanDuel ya se construyen a partir del identificador independiente del estado. Leído como external_market_id ?? market_id para manejar FanDuel y todas las demás casas con una sola expresión.
selection_idstring|undefinedIdentificador de selección/resultado nativo de la casa de apuestas. Algunas casas no lo exponen — ausente cuando no se conoce. En tenis, tenis de mesa, MMA y boxeo, los IDs de SABA, BetOnline, Betsson, SBOBET y Fanatics Markets terminan en el nombre del jugador en lugar del “home”/“away” de la casa de apuestas (desde 2026-10-30; los IDs guardados antes de esa fecha ya no coinciden). En esports, los IDs de SABA y Betsson terminan en el nombre del equipo en lugar del “home”/“away” de la casa de apuestas (desde 2026-10-30; los IDs guardados antes de esa fecha ya no coinciden). Usa selection_type para el lado.
player_namestring|undefinedNombre del jugador, en mercados a nivel de jugador. Está presente en los tipos player_* y también en los mercados de goleador y en los de jugador limitados a un periodo. ⚠ No está garantizado en todas las filas marcadas con is_player_prop: true: en los mercados most_*_player está ausente y el jugador solo aparece en selection.
stat_categorystring|undefinedCategoría estadística, p. ej. points, rebounds (solo mercados de player props)
home_pitcherstring|undefinedSolo MLB. Pitcher abridor del equipo local cuando lo publica la casa de apuestas.
away_pitcherstring|undefinedSolo MLB. Pitcher abridor del equipo visitante cuando lo publica la casa de apuestas.
max_betnumber|undefinedEl mayor tamaño disponible en esta fila. En un corredor tradicional (Pinnacle, Circa Sports, SBOBET) es la apuesta máxima que aceptará, en USD. En un corredor basado en intercambio es el dinero que está al mejor precio, en size_currency. La ausencia significa que el operador no publica ningún tamaño para la fila; un número — incluido 0.0 — es una cifra real. En un corredor basado en intercambio este campo aparece solo mientras hay dinero al mejor precio, así que un best_bid_liquidity de 0.0 llega sin max_bet — el mismo hecho, no uno contradictorio. Polymarket es la excepción: allí los dos campos describen lados opuestos del libro; consulta best_bid_liquidity. Consulta Liquidez y límites.
size_currencystring|undefinedCódigo ISO-4217 en el que están denominadas las cifras monetarias de esta fila: max_bet, best_bid_liquidity y total_liquidity. GBP en Betfair y Smarkets, USD en cualquier otro corredor que publique un tamaño, y nunca convertido: la cifra propia del operador se entrega en su propia moneda. Ausente en filas sin tamaño y en corredores tradicionales, cuyo max_bet es un techo de apuesta en USD y no un tamaño en el libro. Consulta Liquidez y límites.
best_bid_liquiditynumber|undefinedSolo corredores basados en intercambio. Dinero que está al precio publicado — lo que un tomador puede emparejar sin mover el precio. Denominado en size_currency. 0.0 significa que no hay nada ahí; la ausencia significa que el operador no publica la cifra. En Polymarket es el lado del bid, no el precio publicado. Una fila de Polymarket se cotiza a partir del mejor ask; este campo es el dinero que está en el mejor bid del mismo resultado, es decir, el precio del mejor bid por las participaciones en órdenes de compra a ese precio, en USD. El tamaño al precio publicado es max_bet, y los dos rara vez coinciden. En Polymarket este campo nunca es 0.0: si el mejor bid está vacío o su tamaño aún no se conoce, el campo no aparece.
total_liquiditynumber|undefinedSolo corredores basados en intercambio. Tamaño arriesgable sumado en todo el libro para esta selección, no solo al mejor precio. Denominado en size_currency. 0.0 significa un libro vacío; la ausencia significa que el operador no publica la cifra. No derivable de best_bid_liquidity, y algunos corredores publican uno sin el otro.
volumenumber|undefinedVolumen negociado acumulado en esta selección, en las unidades nativas de la casa de intercambio. Solo casas de intercambio — actualmente Kalshi, Novig y Robinhood. Consulta Liquidez y límites.
volume_24hnumber|undefinedVolumen negociado de las últimas 24 horas, en las unidades nativas de la casa de intercambio. Solo casas de intercambio — actualmente Polymarket y Kalshi.
open_interestnumber|undefinedContratos abiertos pendientes sobre esta selección. Solo casas de intercambio — actualmente Kalshi y Robinhood.
polymarket_resolutionstring|undefinedSolo Polymarket. Estado de resolución del oráculo optimista UMA cuando el mercado ha terminado — uno de settled_normal, voided, disputed, proposed, unknown. Ausente en mercados Polymarket aún en vivo y en todas las casas no-Polymarket.

Tipos de selecciónEnlace permanente a esta sección

selection_type lleva el identificador canónico de lado para cada selection. La mayoría de mercados son a dos vías (p. ej. moneyline, point spread, total) y emiten uno de los valores simples siguientes. Un pequeño conjunto de mercados multieje (doble oportunidad de fútbol, BTTS combinado, resultado × O/U, round betting de MMA, set betting de tenis, marcador exacto, etc.) codifica dos resultados por selección y emite valores compuestos unidos por _.

FamiliaValoresDónde aparecen
Dos vías (lado del equipo)home, awaymoneyline, point_spread, puck_line, run_line, set_handicap, la mayoría de mercados por período
Dos vías (dirección de línea)over, undertotal_points, total_goals, total_runs, total_games, total_rounds, todos los props player_*_o_u
Dos vías (sí/no)yes, nobinary, mercados de tipo prop sí/no, resultados de intercambio “back/lay”, mercados de predicción de Polymarket
Dos vías (paridad)even, oddMercados de paridad de totales (p. ej. total de puntos par/impar)
Tres víasdrawMoneyline a tres vías (1X2 de fútbol), lado complementario del draw-no-bet, “sin gol” en next_goal
Compuesto (equipo × O/U)home_over, home_under, away_over, away_under, y draw_over, draw_under en el resultado-más-total de fútbolmoneyline_3-way_+_total_goals de fútbol (“Equipo A y Over N.5”) y 1st_half_moneyline_3-way_+_1st_half_total_goals y mercados análogos resultado-más-total. También team_total (“Equipo A Over N.5”), que lleva un equipo y una dirección, por lo que nunca es un home/over simple.
Compuesto (equipo × BTTS)home_yes, home_no, away_yes, away_no, draw_yes, draw_nomatch_result_both_teams_to_score de fútbol
Compuesto (doble oportunidad)home_draw, away_draw, home_awaydouble_chance de fútbol (1X / X2 / 12), double_chance_reg_time de hockey y doble oportunidad de MMA
Compuesto (round / método)home_r1, home_r2, home_decision, away_r1, etc.round_betting de MMA y mercados de método de victoria
Comodínothergame_prop, “sin gol” en next_goal, y cualquier selección donde el mapeador de lado canónico no pueda descomponer el resultado limpiamente. Siempre presente en volumen bajo; trátalo como opaco.

Parseo de valores compuestos. Las cadenas compuestas de selection_type siempre unen el eje del equipo (home / away / draw) al eje secundario con un único guion bajo. Para recuperar solo el eje del equipo sin parsear, lee team_side — es el lado en bruto sellado por el adaptador para la misma fila.

Los mercados de cola larga emiten formas adicionales. Mercados como correct_score (p. ej. "2_1"), 1st_set_correct_score (p. ej. "6_4"), winning_margin, halftime_fulltime, first_goal y anytime_goal codifican resultados a nivel de marcador o compuestos directamente en selection_type. En tenis, correct_score es el resultado del partido en sets ("2_1": el home_team de la fila gana dos sets a uno), y el marcador en juegos de un set está en 1st_set_correct_score a 5th_set_correct_score. Si dependes de un enum cerrado, filtra a las familias de arriba y trata cualquier valor no reconocido como opaco — no lances error.

Tipos de mercado trasladadosEnlace permanente a esta sección

En noviembre de 2026 algunas casas trasladaron un mercado al market_type que otras casas ya usan para la misma apuesta. Solo cambió market_type: la apuesta, sus selecciones y sus precios son los mismos. Filtra por el id de la columna Ahora.

ApuestaCasasmarket_type anteriorAhoramarket= con el id anterior todavía las devuelve
Fútbol: resultado del partido y total de golesTodasmatch_result_total_goalsmoneyline_3-way_+_total_goalsCon sport=soccer
Fútbol: resultado y goles del 1.er tiempoTodas1st_half_match_result_total_goals1st_half_moneyline_3-way_+_1st_half_total_goalsSí
Fútbol: resultado de cada tiempo (1X2)bovada1st_half_moneyline_3-way, 2nd_half_moneyline_3-way1st_half_moneyline, 2nd_half_moneylineCon sport=soccer
Fútbol: total de puntos de tarjetaspinnacletotal_bookingstotal_card_pointsSí
Fútbol: hándicap de puntos de tarjetaspinnaclecards_handicapasian_handicap_card_pointsSí
Fútbol: jugador marca o asistebovadaplayer_to_score_or_assistplayer_goals_+_assistsSí
Esports: total de kills del equipo, por mapapinnacle1st_map_team_total a 5th_map_team_total1st_map_team_total_kills a 5th_map_team_total_killsSí
Baloncesto y fútbol americano: empate no apuesta por tiempohardrock, ballybet, stake1st_half_draw_no_bet, 2nd_half_draw_no_bet1st_half_moneyline, 2nd_half_moneylineCon sport=basketball o sport=football
Primera canasta, cuentan los tiros librescaesars, stakefirst_basketfirst_basket_including_ftSí
Puntuación fantasyprizepicks, prizepicks_flexplayer_fantasy_score, 1st_half_player_fantasy_scoreplayer_fantasy_score_prizepicks_, 1st_half_player_fantasy_score_prizepicks_; en béisbol player_batting_fantasy_score_prizepicks_ (bateadores), player_pitching_fantasy_score_prizepicks_ (lanzadores)Sí
Puntuación fantasyunderdog, underdog_multipliersplayer_fantasy_scoreplayer_fantasy_score_underdog_Sí
Hockey: doble oportunidad, tiempo reglamentarioballybetdouble_chancedouble_chance_reg_timeCon sport=hockey
Hockey: empate no apuesta, tiempo reglamentarioballybetdraw_no_betmoneyline_reg_timeCon sport=hockey
Hockey: empate no apuesta, tiempo reglamentariobetrivers, betparxdraw_no_bet_reg_timemoneyline_reg_timeCon sport=hockey
Hockey: total del equipo, tiempo reglamentariothescorebetteam_totalteam_total_reg_timeNo

Donde la última columna dice sí, un filtro market= con el id anterior también devuelve las filas del id nuevo, incluidas las casas que ya publicaban el id nuevo antes del traslado. Donde dice no, el id anterior devuelve solo las casas que no se trasladaron.

Filtrado por Rango de CuotasEnlace permanente a esta sección

Usa min_odds y max_odds para filtrar por valor de cuotas americanas.

# Devolver solo cuotas en positivo (+100 y superiores) curl "https://api.sharpapi.io/api/v1/odds?league=nba&min_odds=100" \ -H "X-API-Key: YOUR_API_KEY" # Devolver solo cuotas entre -200 y +200 curl "https://api.sharpapi.io/api/v1/odds?league=nba&min_odds=-200&max_odds=200" \ -H "X-API-Key: YOUR_API_KEY"

Respuesta Agrupada por EventoEnlace permanente a esta sección

Usa group_by=event para agrupar las cuotas por evento en lugar de una lista plana. Esto es útil para construir interfaces centradas en eventos.

curl "https://api.sharpapi.io/api/v1/odds?league=nba&group_by=event" \ -H "X-API-Key: YOUR_API_KEY"
{ "data": [ { "event_id": "33483153", "event_name": "PHI 76ers vs PHO Suns", "sport": "basketball", "league": "nba", "start_time": "2026-01-26T19:00:00Z", "is_live": false, "odds": [ { "id": "draftkings_33483153_moneyline_PHO", "sportsbook": "draftkings", "market_type": "moneyline", "selection": "PHO Suns", "selection_type": "away", "odds_american": -150, "odds_decimal": 1.667, "odds_probability": 0.60, "line": null, "timestamp": "2026-01-26T02:10:24.125Z", "price_updated_at": "2026-01-26T01:52:41.380Z" } ] } ], "meta": { "group_by": "event", "books_available": 5, "filters": { "league": "nba" }, "updated_at": "2026-01-26T02:10:37.846Z" } }

Acceso a Casas por PlanEnlace permanente a esta sección

Las casas de apuestas incluidas en tus resultados de cuotas dependen de tu plan de suscripción:

PlanCasas DisponiblesCasas de Apuestas Incluidas
Free2DraftKings, FanDuel
Hobby5+ BetMGM, Caesars, theScore Bet
Pro15+ Bet365, BetRivers, y más
Sharp25 (de 43)25 casas a tu elección de las 43
EnterpriseTodasTodas las casas de apuestas disponibles

Pinnacle (sharp book) requiere el plan Sharp o superior. Solicitar sportsbook=pinnacle en un plan Free, Hobby o Pro devolverá un error 403 tier_restricted.

Ejemplos de FiltradoEnlace permanente a esta sección

# Obtener cuotas en directo de la NBA de todas tus casas disponibles curl "https://api.sharpapi.io/api/v1/odds?league=nba&is_live=true" \ -H "X-API-Key: YOUR_API_KEY" # Obtener cuotas moneyline y spread para un evento específico curl "https://api.sharpapi.io/api/v1/odds?event_id=nba_76ers_suns_2026-01-26_b3&market=moneyline,spread" \ -H "X-API-Key: YOUR_API_KEY" # Paginar por todas las cuotas de spread de la NFL (usa next_cursor de cada respuesta) curl "https://api.sharpapi.io/api/v1/odds?league=nfl&market=spread&limit=200" \ -H "X-API-Key: YOUR_API_KEY"

Endpoints RelacionadosEnlace permanente a esta sección

  • Odds Delta - Obtén solo las cuotas que cambiaron desde una marca de tiempo dada
  • Best Odds - Obtén las mejores cuotas de todas las casas para cada selección
  • Odds Comparison - Compara cuotas entre casas lado a lado
  • Batch Odds - Obtén cuotas para varios eventos en una sola solicitud
  • Markets - Lista los tipos de mercado disponibles
  • Sportsbooks - Lista las casas de apuestas disponibles y su estado
Last updated on