Mercados de Eventos

Obtenha os tipos de mercado disponíveis para um evento específico, incluindo quantos sportsbooks oferecem cada mercado.


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

Autenticação

Requer API key via cabeçalho X-API-Key, cabeçalho Authorization: Bearer ou parâmetro de consulta api_key. Disponível para todos os planos.

Parâmetros de Caminho

Parâmetro	Tipo	Obrigatório	Descrição
`eventId`	string	Sim	Identificador único do evento (ex.: `evt_nba_bos_lal_20260208`)

Cabeçalhos de Resposta

Todas as respostas incluem cabeçalhos padrão de rate limit e metadados:

Cabeçalho	Descrição
`X-RateLimit-Limit`	Máximo de requisições por minuto para o seu plano
`X-RateLimit-Remaining`	Requisições restantes na janela atual
`X-RateLimit-Reset`	Timestamp Unix de quando a janela do rate limit é redefinida
`X-Data-Delay`	Atraso de dados para o seu plano (ex.: `0s`, `60s`)
`X-Request-Id`	Identificador único da requisição para depuração

Objeto Market

Campo	Tipo	Descrição
`type`	string	Identificador do tipo de mercado (ex.: `moneyline`, `point_spread`, `total_points`)
`selection_count`	integer	Número de seleções distintas dentro deste mercado
`book_count`	integer	Número de sportsbooks que oferecem este mercado
`selections`	array	Lista de objetos Selection para este mercado

Objeto Selection

Campo	Tipo	Descrição
`name`	string	Nome da seleção (ex.: `Boston Celtics`, `Over`, `LeBron James`)
`type`	string	Tipo de seleção (ex.: `home`, `away`, `over`, `under`)
`line`	number	Valor do point spread ou da linha de total. Omitido para mercados sem linhas (ex.: moneyline).
`book_count`	integer	Número de sportsbooks que oferecem esta seleção

Exemplos de Requisições

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

Resposta

Sucesso (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"
  }
}

Respostas de Erro

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

Descoberta de mercados — Determine quais tipos de mercado estão disponíveis antes de solicitar odds, reduzindo chamadas desnecessárias à API
Cobertura de sportsbooks — Veja quais sportsbooks cobrem cada mercado para identificar oportunidades de comparação
Preparação para line shopping — Identifique mercados oferecidos por múltiplos books onde você pode buscar a melhor linha
Disponibilidade de player props — Verifique se mercados de player props estão disponíveis (frequentemente limitados a certos books e mais próximos do horário do jogo)

Use este endpoint para verificar a disponibilidade de mercados antes de chamar Event Odds com um filtro market. Isso evita desperdiçar chamadas à API com tipos de mercado que não existem para um determinado evento.

Endpoints Relacionados

Events - Listar e buscar eventos
Event Details - Obter detalhes do evento com dados de mercado embutidos
Event Odds - Obter todas as odds para este evento
Markets - Listar todos os tipos de mercado na plataforma