Skip to Content
Referencia de la APIEndpoints Enterprise

Endpoints Enterprise

Endpoints avanzados disponibles exclusivamente para suscriptores del nivel Enterprise.

Todos los endpoints de esta página requieren una suscripción Enterprise. Los niveles inferiores recibirán un error 403 tier_restricted.

FuturosEnlace permanente a esta sección

Los futuros son mercados de temporada: campeón, ganador de conferencia y de división, MVP y otros premios, totales de victorias, clasificación a los playoffs. Dos endpoints los sirven:

EndpointDevuelve
GET /api/v1/futuresLos futuros: cada uno con su id, su nombre y las casas de apuestas que lo ofrecen
GET /api/v1/futures/oddsLos futuros con sus cuotas: una fila por casa de apuestas, selección, lado y línea

Lista los futuros para encontrar el id que buscas y pásalo como future_id al endpoint de cuotas.

Futuros canónicosEnlace permanente a esta sección

Las casas de apuestas nombran de forma distinta el mismo mercado y el mismo equipo o jugador. SharpAPI coloca la versión de cada casa de apuestas de un futuro en un único futuro con un solo id y un solo nombre, y cada versión de un equipo o jugador en una única selección con un solo nombre. Así, los precios de un futuro se comparan fila por fila entre casas de apuestas.

  • Id. El id de la liga, dos guiones bajos y el nombre en snake case en minúsculas: nfl__super_bowl_winner, nba__regular_season_wins, england_-_premier_league__championship_winner. Toma los ids del catálogo en lugar de construirlos: un nombre que lleva un año (1st Overall Pick 2027) cambia de id cuando cambia el año.
  • Nombre. Un nombre por futuro, con un estilo fijo: Super Bowl Winner, AFC South Winner, MVP Winner, Regular Season Wins.
  • Selección. El equipo o jugador al que se refiere un precio, bajo su único nombre canónico: San Francisco 49ers y, en fútbol, el nombre completo del club, Arsenal FC. normalized_selection es ese nombre en una forma apta para cruzar datos.
  • Lado y línea. Una fila fija el precio de un lado de una selección: over o under en una línea de una escalera de victorias, yes o no, o ningún lado en un outright.
  • Tipo de futuro. TEAM cuando las selecciones son equipos, PLAYER cuando son jugadores, UNKNOWN cuando no son ni lo uno ni lo otro (un entrenador, una división, un estado).

Formas de filaEnlace permanente a esta sección

Formaselectionselection_linepointsFuturo de ejemplo
OutrightEl equipo, jugador u otro sujeto: Kansas City Chiefsnullnullnfl__super_bowl_winner
EscaleraEl equipo: Buffalo Billsover o underLa línea: 12.5nfl__regular_season_wins
Yes/NoEl sujeto: Buffalo Billsyes o nonullnfl__to_make_the_playoffs
ParDos sujetos unidos por ///: Arizona Cardinals /// Baltimore Ravensnullnullnfl__super_bowl_matchup

Un par conserva el orden de sus dos nombres en una exacta (nfl__super_bowl_exacta) y los lista por orden alfabético en un enfrentamiento (matchup).

Gemelos Yes/NoEnlace permanente a esta sección

Muchos outrights tienen un futuro gemelo, con el id <id>_yes_no y el nombre <Name> Yes/No: nfl__super_bowl_winner y nfl__super_bowl_winner_yes_no. El outright contiene cada precio sobre un sujeto, sin lado. El gemelo repite cada uno de esos precios como una fila yes y añade el precio de la casa de apuestas en contra del sujeto, cuando lo ofrece, como una fila no. Una fila no nunca aparece en el outright. Un gemelo contiene solo filas yes cuando ninguna casa de apuestas ofrece un precio en contra. No todos los outrights tienen gemelo: nba__championship_winner no tiene.

El precio de BetMGM sobre los Kansas City Chiefs, en el outright y en su gemelo:

Futuronameselection_lineprice
nfl__super_bowl_winnerKansas City Chiefsnull900
nfl__super_bowl_winner_yes_noKansas City Chiefs Yesyes900

Lo que no se sirveEnlace permanente a esta sección

La oferta de una casa de apuestas que no encaja en ningún futuro no se sirve: especiales semanales, props de un solo partido, price boosts y mercados de novedad. Una casa de apuestas tiene como máximo una fila por selección, lado y línea en un futuro.

GET /api/v1/futuresEnlace permanente a esta sección

Lista los futuros: cada futuro con las casas de apuestas que lo ofrecen y cuánto hay con precio.

GET /api/v1/futures

Parámetros de consultaEnlace permanente a esta sección

ParámetroTipoPor defectoDescripción
sportstringallFiltra por deporte: un valor, sin distinguir mayúsculas de minúsculas (football, basketball, soccer)
leaguestringallFiltra por liga: un valor, sin distinguir mayúsculas de minúsculas, tal como lo lista /leagues (nfl, nba, england_-_premier_league)
future_typestringallTEAM, PLAYER o UNKNOWN, sin distinguir mayúsculas de minúsculas. Cualquier otro valor devuelve un data vacío.
future_idstringallUn id de futuro o varios, separados por comas

Se devuelve cada futuro que coincide: no hay paginación, y sportsbook, limit y offset se ignoran si se envían.

Solicitud de ejemploEnlace permanente a esta sección

curl "https://api.sharpapi.io/api/v1/futures?league=nfl" \ -H "X-API-Key: YOUR_API_KEY"

RespuestaEnlace permanente a esta sección

Abreviada a tres futuros. meta.count es el número de futuros de la respuesta completa.

{ "success": true, "data": [ { "id": "nfl__1st_overall_pick_2027", "name": "1st Overall Pick 2027", "future_type": "PLAYER", "sport": "football", "league": "nfl", "start_date": "2026-11-07T17:05:00Z", "books_available": [ "betmgm", "betonline", "bwin", "fanduel" ], "selection_count": 88, "odds_count": 198 }, { "id": "nfl__afc_conference_winner", "name": "AFC Conference Winner", "future_type": "TEAM", "sport": "football", "league": "nfl", "start_date": "2026-11-06T01:15:00Z", "books_available": [ "betonline", "saba" ], "selection_count": 16, "odds_count": 32 }, { "id": "nfl__afc_conference_winner_yes_no", "name": "AFC Conference Winner Yes/No", "future_type": "TEAM", "sport": "football", "league": "nfl", "start_date": "2026-11-06T01:15:00Z", "books_available": [ "betonline", "saba" ], "selection_count": 16, "odds_count": 32 } ], "meta": { "count": 47, "updated_at": "2026-10-26T12:39:49.784599258Z" } }

Los futuros se ordenan por league y después por id. meta.updated_at indica cuándo se leyeron los datos de futuros de esta respuesta (RFC 3339), no cuándo se envió la respuesta. Solicitudes consecutivas pueden devolver el mismo valor.

Objeto FutureEnlace permanente a esta sección

CampoTipoDescripción
idstringEl id del futuro (nfl__super_bowl_winner). Pásalo como future_id a /futures/odds.
namestringEl nombre del futuro (Super Bowl Winner). Un gemelo Yes/No termina en Yes/No.
future_typestringTEAM, PLAYER o UNKNOWN
sportstringDeporte (football)
leaguestringId de la liga (nfl)
start_datestring | nullEl inicio más temprano que envía alguna casa de apuestas para este futuro, en UTC (2027-06-01T19:00:00Z), o null si ninguna envía uno. Las casas fechan un mercado de futuros por su cierre o por el comienzo de su evento, así que pueden no coincidir; se muestra el más temprano, aunque ya haya pasado. Para la fecha propia de una casa, pide /futures/odds solo para esa casa.
books_availablearray of stringLas casas de apuestas que ofrecen este futuro, ordenadas por nombre
selection_countintegerSelecciones distintas del futuro
odds_countintegerFilas del futuro: cada casa de apuestas, selección, lado y línea

GET /api/v1/futures/oddsEnlace permanente a esta sección

Obtén los futuros con sus cuotas. Cada futuro trae una fila por casa de apuestas, selección, lado y línea.

GET /api/v1/futures/odds

Parámetros de consultaEnlace permanente a esta sección

ParámetroTipoPor defectoDescripción
future_idstring-Un id de futuro o varios, separados por comas. Obligatorio salvo que se indique league.
leaguestring-Todos los futuros de una liga: sin distinguir mayúsculas de minúsculas, tal como los lista /leagues (nfl). Obligatorio salvo que se indique future_id.
sportstringallFiltra por deporte: un valor, sin distinguir mayúsculas de minúsculas
future_typestringallTEAM, PLAYER o UNKNOWN, sin distinguir mayúsculas de minúsculas. Cualquier otro valor devuelve un data vacío.
sportsbookstringallSolo filas de estas casas de apuestas, separadas por comas (fanduel,betmgm). books se acepta como alias.
team_idstringallSolo filas de estos equipos, ids de equipo separados por comas (kansas_city_chiefs). Una fila cuyo team_id es null nunca coincide.
selectionstringallSolo filas de estas selecciones, nombres separados por comas (Boston Celtics). Se ignoran mayúsculas, acentos y signos de puntuación, así que CJ Stroud encuentra C.J. Stroud. Un valor de normalized_selection también coincide.
is_mainboolean-true: la línea principal de cada escalera y toda fila que no es de una escalera. false: solo las demás líneas de una escalera. Cualquier otro valor se ignora.
limitinteger50Futuros por página, de 1 a 200. Un valor fuera de ese rango (0, negativo, superior a 200, no numérico) pasa a ser 50.
offsetinteger0Futuros que se omiten. Un valor negativo o no numérico pasa a ser 0.

Pasa future_id o league. Una solicitud sin ninguno de los dos devuelve 400 validation_error, de modo que ninguna solicitud pide todas las filas de todas las ligas. Algunos futuros contienen cientos de filas (una exacta del Super Bowl lista cientos de pares de equipos): acota con sportsbook, team_id, selection o is_main.

Solicitudes de ejemploEnlace permanente a esta sección

# El precio de un equipo en un outright, en cada casa de apuestas curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__super_bowl_winner&team_id=kansas_city_chiefs" \ -H "X-API-Key: YOUR_API_KEY" # La escalera de victorias de un equipo curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nba__regular_season_wins&selection=Boston+Celtics" \ -H "X-API-Key: YOUR_API_KEY" # Solo la línea principal de victorias de cada casa de apuestas, para todos los equipos de la NFL curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__regular_season_wins&is_main=true" \ -H "X-API-Key: YOUR_API_KEY" # Todos los futuros de la NBA de una casa de apuestas, dos futuros por página, segunda página curl "https://api.sharpapi.io/api/v1/futures/odds?league=nba&sportsbook=fanduel&limit=2&offset=2" \ -H "X-API-Key: YOUR_API_KEY"

RespuestaEnlace permanente a esta sección

Respuesta a la primera solicitud. Abreviada a dos de sus seis filas; meta.odds_count es el número de filas de la respuesta completa.

{ "success": true, "data": [ { "id": "nfl__super_bowl_winner", "name": "Super Bowl Winner", "future_type": "TEAM", "sport": "football", "league": "nfl", "start_date": "2026-09-10T00:20:00Z", "odds": [ { "id": "nfl__super_bowl_winner:betmgm:kansas_city_chiefs", "sportsbook": "betmgm", "market": "Super Bowl Winner", "name": "Kansas City Chiefs", "selection": "Kansas City Chiefs", "normalized_selection": "kansas_city_chiefs", "selection_line": null, "points": null, "is_main": true, "price": 900, "team_id": "kansas_city_chiefs" }, { "id": "nfl__super_bowl_winner:betonline:kansas_city_chiefs", "sportsbook": "betonline", "market": "Super Bowl Winner", "name": "Kansas City Chiefs", "selection": "Kansas City Chiefs", "normalized_selection": "kansas_city_chiefs", "selection_line": null, "points": null, "is_main": true, "price": 850, "team_id": "kansas_city_chiefs" } ] } ], "pagination": { "limit": 50, "offset": 0, "count": 1, "total": 1, "has_more": false, "next_offset": null }, "meta": { "count": 1, "total": 1, "odds_count": 6, "updated_at": "2026-10-26T12:39:49.784599258Z" } }

Respuesta a la segunda solicitud, una escalera. Abreviada a cuatro de sus diez filas: BetMGM fija precio a una línea, 51.5, en ambos lados, y FanDuel lista solo overs, en seis líneas.

{ "success": true, "data": [ { "id": "nba__regular_season_wins", "name": "Regular Season Wins", "future_type": "TEAM", "sport": "basketball", "league": "nba", "start_date": "2027-06-19T00:40:00Z", "odds": [ { "id": "nba__regular_season_wins:betmgm:boston_celtics:over:51.5", "sportsbook": "betmgm", "market": "Regular Season Wins", "name": "Boston Celtics Over 51.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "over", "points": 51.5, "is_main": true, "price": -145, "team_id": "boston_celtics" }, { "id": "nba__regular_season_wins:betmgm:boston_celtics:under:51.5", "sportsbook": "betmgm", "market": "Regular Season Wins", "name": "Boston Celtics Under 51.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "under", "points": 51.5, "is_main": true, "price": 120, "team_id": "boston_celtics" }, { "id": "nba__regular_season_wins:fanduel:boston_celtics:over:49.5", "sportsbook": "fanduel", "market": "Regular Season Wins", "name": "Boston Celtics Over 49.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "over", "points": 49.5, "is_main": false, "price": -220, "team_id": "boston_celtics" }, { "id": "nba__regular_season_wins:fanduel:boston_celtics:over:54.5", "sportsbook": "fanduel", "market": "Regular Season Wins", "name": "Boston Celtics Over 54.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "over", "points": 54.5, "is_main": true, "price": 130, "team_id": "boston_celtics" } ] } ], "pagination": { "limit": 50, "offset": 0, "count": 1, "total": 1, "has_more": false, "next_offset": null }, "meta": { "count": 1, "total": 1, "odds_count": 10, "updated_at": "2026-10-26T12:41:24.754966665Z" } }

Objeto de filaEnlace permanente a esta sección

Cada futuro de data trae los id, name, future_type, sport y league que lista /futures, un start_date y un array odds con las filas. Un futuro al que no le queda ninguna fila tras los filtros se omite.

Aquí start_date es el inicio más temprano entre las casas de apuestas que la petición indica con sportsbook (todas si no indica ninguna), o null si ninguna de ellas envía uno; una petición para una sola casa devuelve la fecha propia de esa casa. team_id, selection e is_main filtran filas y no cambian start_date.

CampoTipoDescripción
idstringEl id de la fila: el id del futuro, la casa de apuestas y la normalized_selection, y después el lado y los puntos cuando la fila los tiene, unidos por : (nfl__regular_season_wins:betmgm:buffalo_bills:over:12.5). No cambia cuando cambia el precio.
sportsbookstringId de la casa de apuestas (betmgm)
marketstringEl name del futuro, repetido en cada fila
namestringUna etiqueta para mostrar: la selección, después el lado con mayúscula inicial y después los puntos (Kansas City Chiefs, Kansas City Chiefs Yes, Buffalo Bills Over 12.5)
selectionstringEl nombre canónico del equipo o jugador, igual para todas las casas de apuestas (San Francisco 49ers). Un par son dos nombres unidos por ///.
normalized_selectionstringselection en minúsculas, con cada secuencia de caracteres distintos de a-z, dígitos y - sustituida por un único _: C.J. Stroud pasa a ser c_j_stroud y Jaren Jackson Jr. pasa a ser jaren_jackson_jr_. Úsala para cruzar filas entre casas de apuestas.
selection_linestring | nullover o under en una escalera, yes o no en un futuro Yes/No, null en un outright o un par
pointsnumber | nullLa línea de una escalera (12.5). null en toda fila cuyo selection_line no es over ni under.
is_mainbooleantrue en la línea principal de una casa de apuestas en una escalera, false en sus demás líneas. Siempre true en una fila que no es de una escalera. Véase abajo.
priceintegerCuota americana: 900 es +900, -130 es -130. Deriva de ella la cuota decimal y la probabilidad implícita: consulta Formatos de cuotas.
team_idstring | nullEl id del equipo, el mismo id que usan los endpoints de cuotas para los equipos (IDs de referencia de entidades), cuando la selección es un equipo. null en otro caso: un jugador, un par, un entrenador, una división, un estado o un equipo que SharpAPI no puede identificar. No siempre es igual a normalized_selection: Arsenal FC es arsenal.

Líneas principalesEnlace permanente a esta sección

Una casa de apuestas puede listar varias líneas de una escalera para la misma selección. is_main es true en exactamente una línea por casa de apuestas y selección: la línea a la que la casa de apuestas fija precio en ambos lados y cuyos dos precios están más cerca de una cuota igualada. Cuando no fija precio a ninguna línea en ambos lados, como hace FanDuel arriba, es la línea cuyo precio está más cerca de una cuota igualada, aquí 54.5 a +130. Una línea con precio en ambos lados siempre gana a una línea con precio en un solo lado, y en caso de empate gana la línea más baja. is_main=true conserva esas líneas (y toda fila que no es de una escalera); is_main=false conserva las demás.

Orden y paginaciónEnlace permanente a esta sección

Los futuros se ordenan por league y después por id. Las filas dentro de un futuro se ordenan por normalized_selection, después por sportsbook, después por lado (sin lado, over, under, yes, no) y después por points. Las filas no se ordenan por precio: ordena en el cliente.

limit y offset cuentan futuros, no filas. Una página contiene hasta limit futuros, cada uno con todas sus filas que coinciden con los filtros.

CampoTipoDescripción
pagination.limitintegerFuturos por página, tal como se aplicó
pagination.offsetintegerFuturos omitidos antes de esta página
pagination.countintegerFuturos de esta página. Igual que meta.count.
pagination.totalintegerFuturos que coinciden con los filtros, antes de paginar. Igual que meta.total.
pagination.has_morebooleanSi sigue otra página
pagination.next_offsetinteger | nullEl offset de la página siguiente, o null en la última página
meta.countintegerFuturos de data
meta.totalintegerFuturos que coinciden con los filtros, antes de paginar
meta.odds_countintegerFilas de data, entre todos sus futuros
meta.updated_atstringCuándo se leyeron los datos de futuros de esta respuesta (RFC 3339), no cuándo se envió la respuesta. Solicitudes consecutivas pueden devolver el mismo valor.

El sobre de la cuarta solicitud, la segunda página de futuros de la NBA con dos por página. Coinciden 19 futuros; los dos de esta página contienen 13 y 15 filas, así que meta.odds_count es 28.

{ "success": true, "data": [ ... ], "pagination": { "limit": 2, "offset": 2, "count": 2, "total": 19, "has_more": true, "next_offset": 4 }, "meta": { "count": 2, "total": 19, "odds_count": 28, "updated_at": "2026-10-26T12:41:24.754966665Z" } }

ErroresEnlace permanente a esta sección

EstadoCódigoCuándo
400validation_errorSe llamó a /futures/odds sin future_id ni league
401missing_api_key, invalid_api_keyFalta la API key o no es válida
403tier_restrictedEl nivel de la clave es inferior a Enterprise
429rate_limitedSe superó el límite de tasa
503service_unavailableLos datos de futuros no están disponibles temporalmente: no se pudo leer una copia con menos de 5 minutos. Inténtalo más tarde; el header Retry-After indica los segundos de espera.
{ "error": { "code": "validation_error", "message": "Missing required parameter: future_id or league" } }

Un filtro que no coincide con ningún futuro no es un error: la respuesta es 200 con un data vacío.

Migración desde la forma de respuesta anteriorEnlace permanente a esta sección

Ambos endpoints conservan sus rutas y devuelven la forma descrita arriba. La forma anterior ya no se sirve, y ningún parámetro la recupera.

Un future_id de la forma anterior (championship_winner) ya no coincide con nada: la respuesta es 200 con un data vacío. Toma los nuevos ids de GET /api/v1/futures. future_type=OVER_UNDER y future_type=YES_NO también devuelven un data vacío: los tipos de futuro son TEAM, PLAYER y UNKNOWN, y el lado de una fila es su selection_line.

GET /api/v1/futures

AntesAhora
market_id (championship_winner)id (nba__championship_winner): los valores cambiaron
display_name (NBA Championship Winner)name (Championship Winner)
future_type: TEAM, PLAYER, OVER_UNDER, YES_NOfuture_type: TEAM, PLAYER, UNKNOWN
sport, league, selection_count, books_availableSe mantienen
-odds_count
-start_date
-Parámetro de consulta future_id

GET /api/v1/futures/odds

AntesAhora
Una lista plana de filas, paginada por filas, 100 filas por defectoUna lista de futuros, cada uno con un array odds, paginada por futuros, 50 futuros por defecto
future_id obligatoriofuture_id o league obligatorio
selectionselection, y normalized_selection para cruzar datos
sportsbooksportsbook
odds_americanprice
odds_decimal, probabilityEliminados: derívalos de price
linepoints, con el lado en selection_line (over, under, yes, no)
future_market_id, future_market_name, future_type, sport, league en cada filaid, name, future_type, sport, league en el futuro que contiene las filas
event_start_time en cada filastart_date en el futuro que contiene las filas: el inicio más temprano entre las casas consultadas
meta.future_id, meta.books_count, meta.selections_countEliminados
-id, market, name, is_main, team_id en cada fila
-Parámetros de consulta future_type, team_id, selection, is_main

RelacionadoEnlace permanente a esta sección

Last updated on