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 consulta

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

Ejemplos de solicitudes

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'])}")

Respuesta

Éxito (200)


{
  "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 Market

Campo	Tipo	Descripción
`id`	string	Identificador único del mercado (úsalo en los filtros de la API)
`name`	string	Nombre del mercado legible para humanos
`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 mercado

Mercados principales

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 props

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 periodo

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 mercados

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ó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 deporte

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 filtros

Utiliza el id del mercado como parámetro de filtro en otros endpoints:


# 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"

Comprender las líneas

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 relacionados

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