Mercados del Evento

Obtén los tipos de mercado disponibles para un evento específico, incluyendo cuántas casas de apuestas ofrecen cada mercado.


GET /api/v1/events/{eventId}/markets

Autenticación

Requiere API key mediante la cabecera X-API-Key, la cabecera Authorization: Bearer o el parámetro de consulta api_key. Disponible para todos los planes.

Parámetros de Ruta

Parámetro	Tipo	Obligatorio	Descripción
`eventId`	string	Sí	Identificador único del evento (p. ej., `evt_nba_bos_lal_20260208`)

Cabeceras de Respuesta

Todas las respuestas incluyen cabeceras estándar de límite de velocidad y metadatos:

Cabecera	Descripción
`X-RateLimit-Limit`	Máximo de solicitudes por minuto para tu plan
`X-RateLimit-Remaining`	Solicitudes restantes en la ventana actual
`X-RateLimit-Reset`	Marca de tiempo Unix en la que se reinicia la ventana del rate limit
`X-Data-Delay`	Retardo de datos para tu plan (p. ej., `0s`, `60s`)
`X-Request-Id`	Identificador único de la solicitud para depuración

Objeto Market

Campo	Tipo	Descripción
`type`	string	Identificador del tipo de mercado (p. ej., `moneyline`, `point_spread`, `total_points`)
`selection_count`	integer	Número de selecciones distintas dentro de este mercado
`book_count`	integer	Número de casas de apuestas que ofrecen este mercado
`selections`	array	Lista de objetos Selection para este mercado

Objeto Selection

Campo	Tipo	Descripción
`name`	string	Nombre de la selección (p. ej., `Boston Celtics`, `Over`, `LeBron James`)
`type`	string	Tipo de selección (p. ej., `home`, `away`, `over`, `under`)
`line`	number	Valor del hándicap o de la línea total. Se omite en mercados sin línea (p. ej., moneyline).
`book_count`	integer	Número de casas de apuestas que ofrecen esta selección

Ejemplos de Solicitudes

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/markets" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
const response = await fetch(
  `https://api.sharpapi.io/api/v1/events/${eventId}/markets`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
 
// List markets and their selections
for (const market of data) {
  console.log(`${market.type}: ${market.book_count} books, ${market.selection_count} selections`);
  for (const sel of market.selections) {
    console.log(`  ${sel.name} (${sel.type}): ${sel.book_count} books${sel.line !== undefined ? `, line ${sel.line}` : ''}`);
  }
}

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/markets',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
result = response.json()
 
for market in result['data']:
    print(f"{market['type']}: {market['book_count']} books, {market['selection_count']} selections")
    for sel in market['selections']:
        line_info = f", line {sel['line']}" if 'line' in sel else ''
        print(f"  {sel['name']} ({sel['type']}): {sel['book_count']} books{line_info}")

Respuesta

Éxito (200)


{
  "success": true,
  "data": [
    {
      "type": "moneyline",
      "selection_count": 2,
      "book_count": 6,
      "selections": [
        { "name": "Boston Celtics", "type": "home", "book_count": 6 },
        { "name": "Los Angeles Lakers", "type": "away", "book_count": 6 }
      ]
    },
    {
      "type": "point_spread",
      "selection_count": 2,
      "book_count": 6,
      "selections": [
        { "name": "Boston Celtics", "type": "home", "line": -5.5, "book_count": 6 },
        { "name": "Los Angeles Lakers", "type": "away", "line": 5.5, "book_count": 6 }
      ]
    },
    {
      "type": "total_points",
      "selection_count": 2,
      "book_count": 6,
      "selections": [
        { "name": "Over", "type": "over", "line": 220.5, "book_count": 6 },
        { "name": "Under", "type": "under", "line": 220.5, "book_count": 6 }
      ]
    },
    {
      "type": "team_total",
      "selection_count": 4,
      "book_count": 4,
      "selections": [
        { "name": "Boston Celtics Over", "type": "over", "line": 113.5, "book_count": 4 },
        { "name": "Boston Celtics Under", "type": "under", "line": 113.5, "book_count": 4 },
        { "name": "Los Angeles Lakers Over", "type": "over", "line": 106.5, "book_count": 3 },
        { "name": "Los Angeles Lakers Under", "type": "under", "line": 106.5, "book_count": 3 }
      ]
    },
    {
      "type": "player_prop",
      "selection_count": 24,
      "book_count": 4,
      "selections": [
        { "name": "LeBron James Over", "type": "over", "line": 25.5, "book_count": 4 },
        { "name": "LeBron James Under", "type": "under", "line": 25.5, "book_count": 4 },
        { "name": "Jayson Tatum Over", "type": "over", "line": 28.5, "book_count": 3 },
        { "name": "Jayson Tatum Under", "type": "under", "line": 28.5, "book_count": 3 }
      ]
    }
  ],
  "meta": {
    "event_id": "evt_nba_bos_lal_20260208",
    "count": 5,
    "updated_at": "2026-02-08T12:05:00Z"
  }
}

Respuestas de Error

404 Not Found


{
  "error": {
    "code": "not_found",
    "message": "Event not found",
    "docs": "https://docs.sharpapi.io/en/api-reference/events-markets"
  }
}

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

Casos de Uso

Descubrimiento de mercados — Determina qué tipos de mercado están disponibles antes de solicitar las cuotas, reduciendo llamadas innecesarias a la API
Cobertura de casas de apuestas — Comprueba qué casas de apuestas cubren cada mercado para identificar oportunidades de comparación
Preparación para line shopping — Identifica los mercados ofrecidos por varias casas en los que puedes buscar la mejor línea
Disponibilidad de player props — Comprueba si hay mercados de player props disponibles (a menudo limitados a ciertas casas y más cercanos a la hora del partido)

Usa este endpoint para comprobar la disponibilidad de mercados antes de llamar a Cuotas del Evento con un filtro market. Esto evita malgastar llamadas a la API en tipos de mercado que no existen para un evento determinado.

Endpoints Relacionados

Eventos - Listar y buscar eventos
Detalles del Evento - Obtener detalles del evento con datos de mercado integrados
Cuotas del Evento - Obtener todas las cuotas de este evento
Mercados - Listar todos los tipos de mercado en la plataforma