Detalhes do Evento

Obtenha informações detalhadas de um único evento, incluindo mercados disponíveis e metadados.


GET /api/v1/events/{eventId}

Autenticação

Requer API key através do header X-API-Key, do header Authorization: Bearer ou do parâmetro de query api_key. Disponível para todos os tiers.

Parâmetros de Caminho

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

Headers de Resposta

Todas as respostas incluem headers padrão de rate limit e metadados:

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

Objeto de Detalhes do Evento

Campo	Tipo	Descrição
`id`	string	Identificador canônico do evento — o mesmo para cada sportsbook que cobre este evento. Use como sua chave primária para correspondência entre books. Veja Correspondência de Eventos.
`external_ids`	object	Mapa do ID do sportsbook para o ID nativo do evento daquele book (ex.: `{ "draftkings": "12345", "fanduel": "67890" }`). Use estes para deep linking de volta às páginas do sportsbook.
`sport`	string	Identificador do esporte (ex.: `basketball`, `football`)
`league`	string	Nome da liga (ex.: `NBA`, `NFL`)
`home_team`	string	Nome do time da casa
`away_team`	string	Nome do time visitante
`start_time`	string	Horário de início do evento em ISO 8601
`status`	string	Status do evento: `upcoming`, `live`, `final`, `postponed`, `cancelled`
`is_live`	boolean	Se o evento está atualmente ao vivo
`books`	array	Sportsbooks que cobrem este evento, ordenados por contagem de mercados em ordem decrescente
`markets`	array	Tipos de mercado disponíveis para este evento, ordenados por contagem de seleções em ordem decrescente

Array de Books

Cada entrada no array books descreve um sportsbook que possui odds para este evento.

Campo	Tipo	Descrição
`id`	string	Identificador do sportsbook (ex.: `draftkings`, `pinnacle`)
`name`	string	Nome de exibição do sportsbook
`market_count`	integer	Número de tipos de mercado distintos que este book oferece para o evento
`last_update`	string	Timestamp ISO 8601 da atualização de odds mais recente deste book

Array de Markets

Cada entrada no array markets resume um tipo de mercado disponível para este evento.

Campo	Tipo	Descrição
`type`	string	Identificador do tipo de mercado (ex.: `moneyline`, `spread`, `total`, `player_prop`)
`selection_count`	integer	Número de seleções distintas disponíveis neste mercado
`book_count`	integer	Número de sportsbooks oferecendo este mercado

Exemplos de Requisições

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208" \
  -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}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
console.log(`${data.home_team} vs ${data.away_team}`);
console.log(`Markets: ${data.markets.map(m => m.type).join(', ')}`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
event = response.json()['data']
print(f"{event['home_team']} vs {event['away_team']}")
print(f"Markets: {[m['type'] for m in event['markets']]}")

Resposta

Sucesso (200)

Respostas de recurso único envolvem o objeto em data como um objeto único (não como um array).


{
  "data": {
    "id": "evt_nba_bos_lal_20260208",
    "external_ids": {
      "draftkings": "12345678",
      "fanduel": "87654321",
      "pinnacle": "556677889",
      "betmgm": "ms_44556"
    },
    "sport": "basketball",
    "league": "NBA",
    "home_team": "Boston Celtics",
    "away_team": "Los Angeles Lakers",
    "start_time": "2026-02-08T19:30:00Z",
    "status": "upcoming",
    "is_live": false,
    "books": [
      {
        "id": "draftkings",
        "name": "DraftKings",
        "market_count": 5,
        "last_update": "2026-02-08T12:05:00Z"
      },
      {
        "id": "fanduel",
        "name": "FanDuel",
        "market_count": 4,
        "last_update": "2026-02-08T12:04:30Z"
      },
      {
        "id": "pinnacle",
        "name": "Pinnacle",
        "market_count": 3,
        "last_update": "2026-02-08T12:03:00Z"
      },
      {
        "id": "betmgm",
        "name": "BetMGM",
        "market_count": 3,
        "last_update": "2026-02-08T12:02:15Z"
      }
    ],
    "markets": [
      {
        "type": "moneyline",
        "selection_count": 2,
        "book_count": 4
      },
      {
        "type": "spread",
        "selection_count": 2,
        "book_count": 4
      },
      {
        "type": "total",
        "selection_count": 2,
        "book_count": 3
      },
      {
        "type": "player_prop",
        "selection_count": 18,
        "book_count": 2
      },
      {
        "type": "team_total",
        "selection_count": 4,
        "book_count": 1
      }
    ]
  },
  "meta": {
    "event_id": "evt_nba_bos_lal_20260208"
  }
}

Respostas de Erro

404 Not Found


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

401 Unauthorized


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

Casos de Uso

Comparação entre books — O id canônico é o mesmo em todos os sportsbooks, portanto todas as odds retornadas já estão correspondidas ao mesmo evento do mundo real. Veja Correspondência de Eventos.
Análise de mercado — Veja cada tipo de mercado disponível e quantos books oferecem cada um
Referência sharp — Compare odds de soft books contra a Pinnacle (o benchmark sharp)
Deep linking — Use external_ids para direcionar usuários à página do evento de um sportsbook específico

Endpoints Relacionados

Eventos - Lista e pesquisa eventos
Odds do Evento - Obtenha odds paginadas para este evento
Mercados do Evento - Obtenha tipos de mercado disponíveis para este evento
Snapshot de Odds - Obtenha odds atuais em todos os eventos