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:
| Endpoint | Devuelve |
|---|---|
GET /api/v1/futures | Los futuros: cada uno con su id, su nombre y las casas de apuestas que lo ofrecen |
GET /api/v1/futures/odds | Los 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 49ersy, en fútbol, el nombre completo del club,Arsenal FC.normalized_selectiones 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:
overounderen una línea de una escalera de victorias,yesono, o ningún lado en un outright. - Tipo de futuro.
TEAMcuando las selecciones son equipos,PLAYERcuando son jugadores,UNKNOWNcuando no son ni lo uno ni lo otro (un entrenador, una división, un estado).
Formas de filaEnlace permanente a esta sección
| Forma | selection | selection_line | points | Futuro de ejemplo |
|---|---|---|---|---|
| Outright | El equipo, jugador u otro sujeto: Kansas City Chiefs | null | null | nfl__super_bowl_winner |
| Escalera | El equipo: Buffalo Bills | over o under | La línea: 12.5 | nfl__regular_season_wins |
| Yes/No | El sujeto: Buffalo Bills | yes o no | null | nfl__to_make_the_playoffs |
| Par | Dos sujetos unidos por ///: Arizona Cardinals /// Baltimore Ravens | null | null | nfl__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:
| Futuro | name | selection_line | price |
|---|---|---|---|
nfl__super_bowl_winner | Kansas City Chiefs | null | 900 |
nfl__super_bowl_winner_yes_no | Kansas City Chiefs Yes | yes | 900 |
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/futuresParámetros de consultaEnlace permanente a esta sección
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
sport | string | all | Filtra por deporte: un valor, sin distinguir mayúsculas de minúsculas (football, basketball, soccer) |
league | string | all | Filtra por liga: un valor, sin distinguir mayúsculas de minúsculas, tal como lo lista /leagues (nfl, nba, england_-_premier_league) |
future_type | string | all | TEAM, PLAYER o UNKNOWN, sin distinguir mayúsculas de minúsculas. Cualquier otro valor devuelve un data vacío. |
future_id | string | all | Un 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
| Campo | Tipo | Descripción |
|---|---|---|
id | string | El id del futuro (nfl__super_bowl_winner). Pásalo como future_id a /futures/odds. |
name | string | El nombre del futuro (Super Bowl Winner). Un gemelo Yes/No termina en Yes/No. |
future_type | string | TEAM, PLAYER o UNKNOWN |
sport | string | Deporte (football) |
league | string | Id de la liga (nfl) |
start_date | string | null | El 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_available | array of string | Las casas de apuestas que ofrecen este futuro, ordenadas por nombre |
selection_count | integer | Selecciones distintas del futuro |
odds_count | integer | Filas 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/oddsParámetros de consultaEnlace permanente a esta sección
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
future_id | string | - | Un id de futuro o varios, separados por comas. Obligatorio salvo que se indique league. |
league | string | - | 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. |
sport | string | all | Filtra por deporte: un valor, sin distinguir mayúsculas de minúsculas |
future_type | string | all | TEAM, PLAYER o UNKNOWN, sin distinguir mayúsculas de minúsculas. Cualquier otro valor devuelve un data vacío. |
sportsbook | string | all | Solo filas de estas casas de apuestas, separadas por comas (fanduel,betmgm). books se acepta como alias. |
team_id | string | all | Solo filas de estos equipos, ids de equipo separados por comas (kansas_city_chiefs). Una fila cuyo team_id es null nunca coincide. |
selection | string | all | Solo 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_main | boolean | - | 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. |
limit | integer | 50 | Futuros 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. |
offset | integer | 0 | Futuros 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.
| Campo | Tipo | Descripción |
|---|---|---|
id | string | El 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. |
sportsbook | string | Id de la casa de apuestas (betmgm) |
market | string | El name del futuro, repetido en cada fila |
name | string | Una 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) |
selection | string | El 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_selection | string | selection 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_line | string | null | over o under en una escalera, yes o no en un futuro Yes/No, null en un outright o un par |
points | number | null | La línea de una escalera (12.5). null en toda fila cuyo selection_line no es over ni under. |
is_main | boolean | true 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. |
price | integer | Cuota americana: 900 es +900, -130 es -130. Deriva de ella la cuota decimal y la probabilidad implícita: consulta Formatos de cuotas. |
team_id | string | null | El 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.
| Campo | Tipo | Descripción |
|---|---|---|
pagination.limit | integer | Futuros por página, tal como se aplicó |
pagination.offset | integer | Futuros omitidos antes de esta página |
pagination.count | integer | Futuros de esta página. Igual que meta.count. |
pagination.total | integer | Futuros que coinciden con los filtros, antes de paginar. Igual que meta.total. |
pagination.has_more | boolean | Si sigue otra página |
pagination.next_offset | integer | null | El offset de la página siguiente, o null en la última página |
meta.count | integer | Futuros de data |
meta.total | integer | Futuros que coinciden con los filtros, antes de paginar |
meta.odds_count | integer | Filas de data, entre todos sus futuros |
meta.updated_at | string | 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. |
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
| Estado | Código | Cuándo |
|---|---|---|
400 | validation_error | Se llamó a /futures/odds sin future_id ni league |
401 | missing_api_key, invalid_api_key | Falta la API key o no es válida |
403 | tier_restricted | El nivel de la clave es inferior a Enterprise |
429 | rate_limited | Se superó el límite de tasa |
503 | service_unavailable | Los 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
| Antes | Ahora |
|---|---|
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_NO | future_type: TEAM, PLAYER, UNKNOWN |
sport, league, selection_count, books_available | Se mantienen |
| - | odds_count |
| - | start_date |
| - | Parámetro de consulta future_id |
GET /api/v1/futures/odds
| Antes | Ahora |
|---|---|
| Una lista plana de filas, paginada por filas, 100 filas por defecto | Una lista de futuros, cada uno con un array odds, paginada por futuros, 50 futuros por defecto |
future_id obligatorio | future_id o league obligatorio |
selection | selection, y normalized_selection para cruzar datos |
sportsbook | sportsbook |
odds_american | price |
odds_decimal, probability | Eliminados: derívalos de price |
line | points, con el lado en selection_line (over, under, yes, no) |
future_market_id, future_market_name, future_type, sport, league en cada fila | id, name, future_type, sport, league en el futuro que contiene las filas |
event_start_time en cada fila | start_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_count | Eliminados |
| - | 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
- Servidor MCP (Asistentes de IA) - las herramientas
get_futures,get_futures_oddsycompare_futures_linesleen estos endpoints - Ligas - los ids de liga que se pasan como
league - Formatos de cuotas - americanas, decimales y probabilidad implícita