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 consultaPermalink for this section

Parámetro	Tipo	Por defecto	Descripción
`sport`	string	all	Filtrar mercados por deporte (p. ej., `basketball`)

Ejemplos de solicitudesPermalink for this section

cURL


# Listar todos los mercados
curl -X GET "https://api.sharpapi.io/api/v1/markets" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Filtrar por deporte
curl -X GET "https://api.sharpapi.io/api/v1/markets?sport=basketball" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch('https://api.sharpapi.io/api/v1/markets', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
});
const { data, meta } = await response.json();
 
// List markets with event counts
data.forEach(m => {
  const lineInfo = m.hasLine ? 'has line' : 'no line';
  console.log(`${m.name} (${m.id}): ${lineInfo}, ${m.event_count ?? 0} events`);
  if (m.examples.length) console.log(`  Examples: ${m.examples.join(', ')}`);
});

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/markets',
    headers={'X-API-Key': 'YOUR_API_KEY'},
)
result = response.json()
 
for market in result['data']:
    line_info = "has line" if market['hasLine'] else "no line"
    events = market['event_count'] or 0
    print(f"{market['name']} ({market['id']}): {line_info}, {events} events")
    if market['examples']:
        print(f"  Examples: {', '.join(market['examples'])}")

RespuestaPermalink for this section

Éxito (200)Permalink for this section


{
  "data": [
    {
      "id": "moneyline",
      "name": "Moneyline",
      "description": "Bet on which team will win the game outright",
      "hasLine": false,
      "examples": ["Lakers -150", "Celtics +130"],
      "event_count": 142,
      "selection_count": 312,
      "sports": ["baseball", "basketball", "football", "hockey", "mma", "soccer", "tennis"]
    },
    {
      "id": "point_spread",
      "name": "Point Spread",
      "description": "Bet on the point margin between teams",
      "hasLine": true,
      "examples": ["Lakers -4.5 (-110)", "Celtics +4.5 (-110)"],
      "event_count": 98,
      "selection_count": 210,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "total_points",
      "name": "Total Points",
      "description": "Bet on the combined score of both teams (over/under)",
      "hasLine": true,
      "examples": ["Over 220.5 (-110)", "Under 220.5 (-110)"],
      "event_count": 95,
      "selection_count": 198,
      "sports": ["baseball", "basketball", "football", "hockey", "soccer", "tennis"]
    },
    {
      "id": "team_total",
      "name": "Team Total",
      "description": "Bet on the score of one specific team",
      "hasLine": true,
      "examples": ["Lakers Over 112.5", "Lakers Under 112.5"],
      "event_count": 64,
      "selection_count": 140,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "player_prop",
      "name": "Player Prop",
      "description": "Bet on individual player performance statistics",
      "hasLine": true,
      "examples": ["LeBron James Over 25.5 Points", "Stephen Curry Over 4.5 3-Pointers"],
      "event_count": 52,
      "selection_count": 1840,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "game_prop",
      "name": "Game Prop",
      "description": "Bet on specific game events or occurrences",
      "hasLine": false,
      "examples": ["First Team to Score", "Will there be Overtime?"],
      "event_count": 30,
      "selection_count": 86,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "future",
      "name": "Future",
      "description": "Long-term bets on season outcomes or championships",
      "hasLine": false,
      "examples": ["NBA Championship Winner", "MVP Award Winner"],
      "event_count": 12,
      "selection_count": 48,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "1st_half",
      "name": "1st Half",
      "description": "1st Half",
      "hasLine": true,
      "examples": [],
      "event_count": 40,
      "selection_count": 96,
      "sports": ["basketball", "football"]
    },
    {
      "id": "1st_quarter",
      "name": "1st Quarter",
      "description": "1st Quarter",
      "hasLine": true,
      "examples": [],
      "event_count": 28,
      "selection_count": 64,
      "sports": ["basketball", "football"]
    }
  ],
  "meta": {
    "count": 9,
    "total_events": 561,
    "total_selections": 2994,
    "rate_limit": {
      "limit": 10,
      "remaining": 9,
      "reset": 1706270460
    }
  }
}

Esquema del objeto MarketPermalink for this section

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. No es un valor de filtro: usa `id` en su lugar.
`description`	string	Breve descripción del mercado
`hasLine`	boolean	Indica si este mercado incluye un valor de línea
`examples`	string[]	Ejemplos de selecciones para este mercado
`event_count`	number \| null	Número de eventos que ofrecen actualmente este mercado
`selection_count`	number \| null	Número de selecciones únicas en todos los eventos
`sports`	string[]	IDs de deportes que actualmente tienen este mercado

Tipos de mercadoPermalink for this section

Mercados principalesPermalink for this section

Los mercados de apuestas más populares y ampliamente disponibles.

Mercado	Descripción	hasLine	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 propsPermalink for this section

Apuestas de proposición de jugador y de partido para resultados más específicos.

Mercado	Descripción	hasLine	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 periodoPermalink for this section

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

Mercado	Descripción	hasLine
`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 mercadosPermalink for this section

Mercado	Descripción	hasLine	Ejemplos
`future`	Apuestas a largo plazo sobre resultados de temporada o campeonatos	No	NBA Championship Winner, MVP Award Winner

Tipos de selecciónPermalink for this section

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 deportePermalink for this section

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 filtrosPermalink for this section

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 cuotasPermalink for this section

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íneasPermalink for this section

Los mercados con hasLine: true incluyen un valor de línea numérico 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 con hasLine: false (como moneyline) tendrán line: null en la respuesta de odds.

Endpoints relacionadosPermalink for this section

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