Mercados
Obtén los tipos de mercados disponibles, sus configuraciones y disponibilidad por deporte.
GET /api/v1/marketsRequiere una API key. Disponible en todos los planes (Free incluido). Las solicitudes no autenticadas devuelven 401.
Parámetros de consultaEnlace permanente a esta sección
Todos los parámetros son opcionales. Sin ninguno, la respuesta lista cada mercado que tiene un precio actual. catalog=true lista cada mercado, con o sin precio.
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
sport | string | — | Solo mercados con precio en estos deportes; varios separados por comas (basketball,hockey). event_count, sportsbooks y sports cubren entonces solo los deportes solicitados. |
league | string | — | Solo mercados con precio en estas ligas; varias separadas por comas. Usa el id de Ligas. Un evento que comparten dos ligas solicitadas cuenta una vez. |
markets_only | boolean | true | false añade coverage a cada fila: las casas de apuestas que ponen precio al mercado en cada deporte y liga. Un valor que no es booleano devuelve 400 con el código validation_error. |
catalog | boolean | false | true lista cada mercado de la lista de mercados, con o sin precio, y añade priced a cada fila. Consulta Vista de catálogo. Un valor que no es booleano devuelve 400 con el código validation_error. |
Varios valores en sport o league devuelven la unión, y con ambos parámetros un mercado debe cumplir los dos. Una respuesta acotada repite los sport y league que aplicó. Un valor sin cuotas en vivo en este momento (o que no publicamos) no es un error: la respuesta trae las filas de los demás valores, o data: [], más un filter_warning que lo nombra:
{
"data": [],
"filter_warning": {
"code": "unknown_league",
"message": "no odds are live for these leagues right now, or the ids are not ones we publish; see GET /api/v1/leagues for the current list",
"unknown_leagues": ["xyz"]
},
"league": "xyz",
"updated_at": "2026-11-09T16:40:45.488543236Z"
}Para un deporte, el código es unknown_sport y la lista es unknown_sports.
Ejemplos de solicitudesEnlace permanente a esta sección
cURL
# Listar todos los mercados
curl -X GET "https://api.sharpapi.io/api/v1/markets" \
-H "X-API-Key: YOUR_API_KEY"
# Solo mercados de la NBA, con las casas de apuestas de cada liga
curl -X GET "https://api.sharpapi.io/api/v1/markets?league=nba&markets_only=false" \
-H "X-API-Key: YOUR_API_KEY"
# Cada mercado, con o sin precio
curl -X GET "https://api.sharpapi.io/api/v1/markets?catalog=true" \
-H "X-API-Key: YOUR_API_KEY"RespuestaEnlace permanente a esta sección
Éxito (200)Enlace permanente a esta sección
Respuesta real, truncada a dos de los tipos de mercado que se devuelven actualmente (ordenados por event_count de forma descendente):
{
"data": [
{
"id": "moneyline",
"name": "Moneyline",
"numerical_id": 878,
"event_count": 6910,
"sports": ["aussie_rules", "badminton", "baseball", "basketball", "boxing", "cricket", "darts", "esports", "floorball", "football", "golf", "handball", "hockey", "mma", "rugby_league", "rugby_union", "snooker", "soccer", "table_tennis", "tennis", "volleyball"],
"sportsbooks": ["ballybet", "bet365", "betfair", "betfair_lay", "betfred", "betmgm", "betonline", "betparx", "betrivers", "betsson", "betvictor", "betway", "bovada", "bwin", "caesars", "circa", "codere", "coral", "draftkings", "eighteenbet", "fanatics", "fanatics_markets", "fanduel", "fliff", "gemini", "ggbet", "goldrush", "hardrock", "kalshi", "ladbrokes", "ladbrokes_uk", "matchbook", "novig", "onexbet", "paddypower", "pinnacle", "polymarket", "prophetx", "rebet", "robinhood", "saba", "sbobet", "skybet", "smarkets", "sport888_it", "sportzino", "stake", "sx_bet", "thescorebet", "thrillzz", "unibet"]
},
{
"id": "2nd_half_team_total",
"name": "2nd Half Team Total",
"numerical_id": 331,
"event_count": 42,
"sports": ["basketball", "football"],
"sportsbooks": ["draftkings", "fanduel", "hardrock"]
}
],
"updated_at": "2026-11-09T16:44:28.388212051Z"
}Esquema del objeto MarketEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Slug del mercado: es exactamente el valor que los endpoints de cuotas aceptan como market_type= (o su alias market=). Consulta la sección sobre uso de mercados en filtros más abajo. |
name | string | Etiqueta legible, solo para mostrar: la etiqueta de la lista de mercados o, para un mercado que la lista aún no tiene, un nombre construido a partir de id. Consulta Nombres. No es un valor de filtro: usa id en su lugar. |
numerical_id | integer | Clave entera estable (congelada, nunca se reutiliza; se omite si no está asignada). Novedad (mayo de 2026): aditiva y opcional. Consulta los IDs de referencia de entidades. |
event_count | integer | Número de eventos distintos con al menos un precio actual en este mercado, sumando todas las casas de apuestas, dentro del alcance sport / league de la solicitud. Un evento cuenta una vez, sin importar cuántas casas, líneas y selecciones le pongan precio. |
sports | string[] | IDs de deportes que actualmente tienen este mercado (con sport=, solo los deportes solicitados) |
sportsbooks | string[] | IDs de casas de apuestas con al menos un precio actual en este mercado, dentro del alcance de la solicitud, ordenados. Nunca es null. |
coverage | object[] | Solo con markets_only=false. Consulta coverage. |
priced | boolean | Solo con catalog=true. true cuando al menos una casa de apuestas tiene un precio actual en este mercado dentro del alcance de la solicitud. Consulta Vista de catálogo. |
coverageEnlace permanente a esta sección
Con markets_only=false, cada fila incluye además coverage: los deportes en los que el mercado tiene precio, las ligas de cada deporte y las casas de apuestas que le ponen precio en cada liga. Deportes y ligas se ordenan por id, y el id de una liga es el que devuelve Ligas. En una solicitud acotada, coverage contiene solo los deportes y ligas solicitados. Fila real de ?markets_only=false:
{
"id": "2nd_half_team_total",
"name": "2nd Half Team Total",
"numerical_id": 331,
"event_count": 42,
"sports": ["basketball", "football"],
"sportsbooks": ["draftkings", "fanduel", "hardrock"],
"coverage": [
{
"id": "basketball",
"leagues": [
{ "id": "nba", "sportsbooks": ["draftkings"] },
{ "id": "ncaab", "sportsbooks": ["fanduel"] }
]
},
{
"id": "football",
"leagues": [
{ "id": "nfl", "sportsbooks": ["draftkings", "fanduel", "hardrock"] }
]
}
]
}Un precio en un evento cuya liga no podemos identificar sigue añadiendo su casa de apuestas a sportsbooks de la fila, pero no aparece bajo ninguna liga en coverage. Así, una casa puede estar en sportsbooks sin aparecer en ninguna liga, y coverage es [] (nunca null) para un mercado con precio solo en esos eventos.
Vista de catálogo (catalog=true)Enlace permanente a esta sección
Sin catalog, la respuesta lista solo los mercados con un precio actual, así que falta un mercado al que ninguna casa de apuestas pone precio ahora. catalog=true lista cada mercado de la lista de mercados, con o sin precio: 1.532 filas el 2026-11-11, frente a 673 sin el parámetro. Cada fila lleva entonces priced:
priced: true: al menos una casa de apuestas tiene un precio actual en el mercado. La fila es la misma que sin el parámetro.priced: false: ninguna casa de apuestas pone precio al mercado ahora.event_countes0,sportsysportsbooksson[](nunca null), y conmarkets_only=false,coveragees[].
Un mercado con precio que la lista de mercados aún no tiene se devuelve igualmente, con priced: true y sin numerical_id, así que la vista de catálogo siempre contiene cada fila de la respuesta sin el parámetro. Las filas mantienen el orden habitual, event_count de forma descendente, así que los mercados sin precio van al final, ordenados por id. Fila real sin precio de ?catalog=true:
{
"id": "4th_map_team_total_kills",
"name": "4th Map Team Total Kills",
"numerical_id": 601,
"event_count": 0,
"sports": [],
"sportsbooks": [],
"priced": false
}La lista de mercados no dice a qué deportes o ligas pertenece un mercado. Por eso, con sport o league, catalog=true devuelve solo las filas con precio de ese alcance (las mismas filas que sin el parámetro, cada una con priced: true) y deja fuera los mercados sin precio. Sin el parámetro, o con catalog=false, la respuesta lista solo los mercados con precio, como antes, y sus filas no llevan el campo priced.
Cambio (noviembre de 2026): los nombres vienen de la lista de mercadosEnlace permanente a esta sección
Desde el 2026-11-11, el name de un mercado es la etiqueta que le da la lista de mercados. Antes, la mayoría de los nombres se construían a partir del id, con cada palabra en mayúscula inicial. 93 de los mercados con precio ese día cambiaron de nombre una vez; id, numerical_id y todos los recuentos no cambian. Ejemplos:
id | Antes | Ahora |
|---|---|---|
defensive_poy | Defensive Poy | Defensive Player of the Year |
halftime_fulltime | Halftime Fulltime | Halftime / Fulltime |
1st_half_total_goals_odd_even | 1st Half Total Goals Odd Even | 1st Half Total Goals Odd/Even |
binary | Binary | Binary (Prediction Market) |
Un mercado que la lista aún no tiene conserva el nombre construido a partir de su id. Mercados del Evento y Cuotas por Lotes envían el mismo nombre como market_label, así que un mercado tiene un solo nombre en cada endpoint. Si identificas mercados por name, usa id en su lugar.
Cambio (noviembre de 2026): event_count cuenta eventosEnlace permanente a esta sección
Antes del 2026-11-09, event_count contaba precios (cada línea y selección en cada casa de apuestas), no eventos. Ahora cada evento cuenta una vez, así que los valores bajaron mucho: en el catálogo completo, point_spread pasó de unos 110.000 a unos 3.100. Si ordenas o filtras mercados por event_count, revisa tus umbrales. El mismo cambio añadió sportsbooks y markets_only=false.
Tipos de mercadoEnlace permanente a esta sección
Las tablas siguientes son una referencia descriptiva de mercados. La columna Tiene línea describe el tipo de mercado, no es un campo de la respuesta de /markets (los campos de la respuesta se listan en la tabla del esquema más arriba).
Mercados principalesEnlace permanente a esta sección
Los mercados de apuestas más populares y ampliamente disponibles.
| Mercado | Descripción | Tiene línea | Ejemplos |
|---|---|---|---|
moneyline | Elige al ganador directo | No | Lakers -150, Celtics +130 |
point_spread | Apuesta con hándicap de puntos | Sí | Lakers -4.5 (-110), Celtics +4.5 (-110) |
total_points | Más/Menos del marcador combinado | Sí | Over 220.5 (-110), Under 220.5 (-110) |
team_total | Apuesta por el marcador de un equipo | Sí | Lakers Over 112.5, Lakers Under 112.5 |
Mercados de propsEnlace permanente a esta sección
Apuestas de proposición de jugador y de partido para resultados más específicos.
| Mercado | Descripción | Tiene línea | Ejemplos |
|---|---|---|---|
player_prop | Estadísticas individuales del jugador (puntos, rebotes, asistencias, etc.) | Sí | LeBron James Over 25.5 Points |
game_prop | Resultados específicos del partido (si habrá prórroga, etc.) | No | First Team to Score |
Mercados por periodoEnlace permanente a esta sección
Mercados para periodos específicos dentro de un partido (mitades, cuartos).
| Mercado | Descripción | Tiene línea |
|---|---|---|
1st_half | Moneyline, hándicap o total de la 1.ª mitad | Sí |
1st_quarter | Moneyline, hándicap o total del 1.er cuarto | Sí |
Otros mercadosEnlace permanente a esta sección
| Mercado | Descripción | Tiene línea | Ejemplos |
|---|---|---|---|
future | Apuestas a largo plazo sobre resultados de temporada o campeonatos | No | NBA Championship Winner, MVP Award Winner |
Tipos de selecciónEnlace permanente a esta sección
| Tipo | Usado en | Descripción |
|---|---|---|
home | Moneyline, Hándicap, Periodo | El equipo local gana o cubre |
away | Moneyline, Hándicap, Periodo | El equipo visitante gana o cubre |
over | Total, Props, Periodo | Por encima del valor de línea |
under | Total, Props, Periodo | Por debajo del valor de línea |
yes | Game Props, Team Props | El resultado ocurre |
no | Game Props, Team Props | El resultado no ocurre |
Disponibilidad de mercados por deporteEnlace permanente a esta sección
| Deporte | Moneyline | Hándicap | Total | Player Props | Team Props | Periodo |
|---|---|---|---|---|---|---|
| Basketball (NBA) | Sí | Sí | Sí | Sí | Sí | Sí |
| Football (NFL) | Sí | Sí | Sí | Sí | Sí | Sí |
| Baseball (MLB) | Sí | Sí | Sí | Sí | Sí | Sí |
| Hockey (NHL) | Sí | Sí | Sí | Sí | Sí | Sí |
| Basketball (NCAAB) | Sí | Sí | Sí | Limitado | Limitado | Sí |
| Football (NCAAF) | Sí | Sí | Sí | Limitado | Limitado | Sí |
| Soccer | Sí | Sí | Sí | Limitado | Limitado | Limitado |
| Tennis | Sí | No | Sí | Limitado | No | No |
| MMA (UFC) | Sí | No | No | Limitado | No | No |
| Golf (PGA) | Sí | No | No | Limitado | No | No |
“Limitado” significa que el mercado está disponible para algunos eventos pero no para todos, dependiendo de la casa de apuestas y del evento. Utiliza los endpoints de odds para ver qué mercados están disponibles para un evento específico.
Uso de mercados en filtrosEnlace permanente a esta sección
Utiliza el id del mercado como parámetro de filtro en otros endpoints. Los endpoints de cuotas lo aceptan como market_type= o, de forma equivalente, como market=. El campo name es una etiqueta de visualización y no un valor de filtro.
# Get only moneyline odds
curl "https://api.sharpapi.io/api/v1/odds?market=moneyline" \
-H "X-API-Key: YOUR_API_KEY"
# Get spread and total odds
curl "https://api.sharpapi.io/api/v1/odds?market=point_spread,total_points" \
-H "X-API-Key: YOUR_API_KEY"
# Get player props only
curl "https://api.sharpapi.io/api/v1/odds?market=player_prop" \
-H "X-API-Key: YOUR_API_KEY"
# Best odds for moneyline markets
curl "https://api.sharpapi.io/api/v1/odds/best?market=moneyline" \
-H "X-API-Key: YOUR_API_KEY"Ejemplo práctico: de una fila de /markets a una consulta de cuotasEnlace permanente a esta sección
En las props es donde más se diferencian el nombre visible y el slug, así que ahí es donde importa la correspondencia. Toma esta fila de la respuesta de /markets (se omiten otros campos):
{
"id": "player_longest_reception",
"name": "Player Longest Reception",
"sports": ["football"]
}Pasa el id — player_longest_reception — y no el name:
curl "https://api.sharpapi.io/api/v1/odds?market_type=player_longest_reception&league=nfl" \
-H "X-API-Key: YOUR_API_KEY"Cada fila devuelta repite el mismo slug en su propio campo market_type, por lo que siempre puedes volver desde un resultado a su entrada en /markets.
Comprender las líneasEnlace permanente a esta sección
Los mercados que tienen línea incluyen un valor numérico line en la respuesta de odds:
- Hándicap: El hándicap de puntos (p. ej.,
-6.5significa que el equipo debe ganar por 7 o más) - Total: El umbral del marcador combinado (p. ej.,
215.5para más/menos) - Player Props: El umbral estadístico (p. ej.,
24.5puntos para un jugador) - Team Props: El umbral estadístico del equipo (p. ej.,
105.5puntos totales del equipo)
Los mercados sin línea (como moneyline) tienen line: null en la respuesta de odds. El catálogo de /markets no indica de qué tipo es cada mercado; lee line en las propias filas de odds.
Endpoints relacionadosEnlace permanente a esta sección
- Snapshot de odds - Filtra odds por tipo de mercado
- Mejores odds - Mejores odds filtradas por mercado
- Deportes - Consulta qué deportes están disponibles
- Casas de apuestas - Consulta qué casas admiten qué mercados