Skip to Content

Mercados

Obtén los tipos de mercados disponibles, sus configuraciones y disponibilidad por deporte.

GET /api/v1/markets

Requiere 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ámetroTipoPor defectoDescripción
sportstring—Solo mercados con precio en estos deportes; varios separados por comas (basketball,hockey). event_count, sportsbooks y sports cubren entonces solo los deportes solicitados.
leaguestring—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_onlybooleantruefalse 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.
catalogbooleanfalsetrue 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

# 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

CampoTipoDescripción
idstringSlug 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.
namestringEtiqueta 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_idintegerClave 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_countintegerNú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.
sportsstring[]IDs de deportes que actualmente tienen este mercado (con sport=, solo los deportes solicitados)
sportsbooksstring[]IDs de casas de apuestas con al menos un precio actual en este mercado, dentro del alcance de la solicitud, ordenados. Nunca es null.
coverageobject[]Solo con markets_only=false. Consulta coverage.
pricedbooleanSolo 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_count es 0, sports y sportsbooks son [] (nunca null), y con markets_only=false, coverage es [].

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:

idAntesAhora
defensive_poyDefensive PoyDefensive Player of the Year
halftime_fulltimeHalftime FulltimeHalftime / Fulltime
1st_half_total_goals_odd_even1st Half Total Goals Odd Even1st Half Total Goals Odd/Even
binaryBinaryBinary (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.

MercadoDescripciónTiene líneaEjemplos
moneylineElige al ganador directoNoLakers -150, Celtics +130
point_spreadApuesta con hándicap de puntosSíLakers -4.5 (-110), Celtics +4.5 (-110)
total_pointsMás/Menos del marcador combinadoSíOver 220.5 (-110), Under 220.5 (-110)
team_totalApuesta por el marcador de un equipoSí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.

MercadoDescripciónTiene líneaEjemplos
player_propEstadísticas individuales del jugador (puntos, rebotes, asistencias, etc.)SíLeBron James Over 25.5 Points
game_propResultados específicos del partido (si habrá prórroga, etc.)NoFirst Team to Score

Mercados por periodoEnlace permanente a esta sección

Mercados para periodos específicos dentro de un partido (mitades, cuartos).

MercadoDescripciónTiene línea
1st_halfMoneyline, hándicap o total de la 1.ª mitadSí
1st_quarterMoneyline, hándicap o total del 1.er cuartoSí

Otros mercadosEnlace permanente a esta sección

MercadoDescripciónTiene líneaEjemplos
futureApuestas a largo plazo sobre resultados de temporada o campeonatosNoNBA Championship Winner, MVP Award Winner

Tipos de selecciónEnlace permanente a esta sección

TipoUsado enDescripción
homeMoneyline, Hándicap, PeriodoEl equipo local gana o cubre
awayMoneyline, Hándicap, PeriodoEl equipo visitante gana o cubre
overTotal, Props, PeriodoPor encima del valor de línea
underTotal, Props, PeriodoPor debajo del valor de línea
yesGame Props, Team PropsEl resultado ocurre
noGame Props, Team PropsEl resultado no ocurre

Disponibilidad de mercados por deporteEnlace permanente a esta sección

DeporteMoneylineHándicapTotalPlayer PropsTeam PropsPeriodo
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íLimitadoLimitadoSí
Football (NCAAF)SíSíSíLimitadoLimitadoSí
SoccerSíSíSíLimitadoLimitadoLimitado
TennisSíNoSíLimitadoNoNo
MMA (UFC)SíNoNoLimitadoNoNo
Golf (PGA)SíNoNoLimitadoNoNo

“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.5 significa que el equipo debe ganar por 7 o más)
  • Total: El umbral del marcador combinado (p. ej., 215.5 para más/menos)
  • Player Props: El umbral estadístico (p. ej., 24.5 puntos para un jugador)
  • Team Props: El umbral estadístico del equipo (p. ej., 105.5 puntos 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

Last updated on