Detalhes do Evento
Obtenha informações detalhadas de um único evento, incluindo mercados disponíveis e metadados.
GET /api/v1/events/{eventId}AutenticaçãoLink permanente para esta seçã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 CaminhoLink permanente para esta seção
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
eventId | string | Sim | Identificador único do evento (ex.: evt_nba_bos_lal_20260208) |
Headers de RespostaLink permanente para esta seção
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 EventoLink permanente para esta seção
| 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. Ausente em um evento finalizado servido a partir do armazenamento de retenção — verifique a presença da chave, não o status. |
completed_at | string | Horário de conclusão em ISO 8601. Presente apenas em linhas com status: "final". |
status | string | Status do evento: upcoming, live, final ou unconfirmed. O status é live quando nosso rastreamento de jogos mostra o jogo em andamento, ou quando várias casas de apostas oferecem preços ao vivo nele. unconfirmed significa que o feed ao vivo deixou de incluir o jogo antes de mostrar um estado de fim de jogo. O último placar visto não é um resultado final, is_live é false e não há completed_at. Entre os endpoints de eventos, só este retorna unconfirmed; a lista /events nunca retorna, e ?status=unconfirmed não é um valor de filtro ali. O Live Game State mostra o mesmo jogo como uma linha não confirmada. |
is_live | boolean | Se o jogo está ao vivo: true quando status é live. |
live_book_count | integer | Quantas casas de apostas têm pelo menos um preço ao vivo neste evento. Sempre presente, 0 quando nenhuma. Pode ser maior que 0 em um evento que não está live. Em um evento live, 0 significa que só o nosso rastreamento de jogos mostra o jogo em andamento. |
season_type | string | "Preseason" ou "Regular Season". Omitido quando não é conhecido: uma liga sem calendário de temporada publicado (hoje todas as ligas exceto nba), uma data fora do calendário ou um evento sem horário de início. A ausência do campo nunca significa temporada regular. |
event_group | string | Nome do card ou torneio que as casas de apostas publicam (ex.: UFC Fight Night), o mesmo valor da lista /events. Omitido quando nenhuma casa o envia, e em alguns eventos encerrados. |
event_group_slug | string | event_group em formato seguro para URL (ex.: ufc-fight-night). Presente exatamente quando event_group estiver. |
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 |
last_seen | object | Presente apenas quando status é unconfirmed e sua chave tem o add-on Game State ou o tier Enterprise. O último placar que o feed ao vivo mostrou, descrito abaixo. |
result | object | Presente apenas quando status é final e sua chave tem o add-on Game State ou o tier Enterprise. O resultado final, descrito abaixo. |
result_access | string | Presente apenas quando status é final ou unconfirmed. granted: sua chave recebe result (em final) ou last_seen (em unconfirmed). requires_game_state_addon: esse objeto é retido para sua chave. |
source | string | confirmed em um evento final cujo resultado foi confirmado depois que o feed ao vivo deixou de mostrar o jogo. Ausente quando o feed ao vivo mostrou o fim do jogo. |
Array de BooksLink permanente para esta seção
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 MarketsLink permanente para esta seção
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 |
Objeto last_seenLink permanente para esta seção
Presente apenas em um evento unconfirmed, e apenas para uma chave com o add-on Game State ou o tier Enterprise. Sem o add-on, o evento continua respondendo status: "unconfirmed", mas sem last_seen. Ele contém o último frame que o feed ao vivo mostrou antes de deixar de incluir o jogo, por exemplo 97-81 no Q4 4:59. Não é um placar final; não o trate como o resultado.
| Campo | Tipo | Descrição |
|---|---|---|
home_score | integer | Placar do time da casa no último frame visto. Um número de sets quando score_type é sets |
away_score | integer | Placar do time visitante no último frame visto. Um número de sets quando score_type é sets |
score_type | string | sets para tênis, tênis de mesa, vôlei e badminton; points para todos os outros esportes |
game_period | string | Período no último frame visto (ex.: Q4). Omitido quando o feed não enviou nenhum |
game_clock | string | Relógio de jogo no último frame visto (ex.: 4:59). Omitido quando o feed não enviou nenhum |
seen_at | string | Horário ISO 8601 em que o feed ao vivo mostrou o jogo pela última vez |
Objeto resultLink permanente para esta seção
Presente apenas em um evento final, e apenas para uma chave com o add-on Game State ou o tier Enterprise. Sem o add-on, o evento continua respondendo status: "final" e completed_at, com result_access: "requires_game_state_addon" e sem result. Nunca é null nem preenchido com zeros, então um result ausente nunca significa um 0-0.
| Campo | Tipo | Descrição |
|---|---|---|
event_id | string | O identificador do evento |
sport | string | Identificador do esporte |
league | string | Slug da liga |
home_team | string | Nome do time da casa |
away_team | string | Nome do time visitante |
final_home_score | integer | Placar final do time da casa. Um número de sets quando score_type é sets |
final_away_score | integer | Placar final do visitante. Um número de sets quando score_type é sets |
winner | string | home, away ou draw. Omitido quando o vencedor não pode ser determinado |
score_type | string | sets para tênis, tênis de mesa, vôlei e badminton; points para todos os outros esportes. Omitido em um registro antigo cuja forma de pontuação não pode ser determinada |
period_scores | object | Placar final por período, com chave pelo rótulo do período (ex.: Q1, OT, 1H, SETS), cada um { "home", "away" }. Omitido quando não há detalhamento |
event_completed_at | string | O mesmo valor de completed_at do evento |
Exemplos de RequisiçõesLink permanente para esta seção
cURL
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208" \
-H "X-API-Key: YOUR_API_KEY"RespostaLink permanente para esta seção
Sucesso (200)Link permanente para esta seção
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,
"live_book_count": 0,
"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 ErroLink permanente para esta seção
404 Not Found
{
"error": {
"code": "not_found",
"message": "Event not found",
"docs": "https://docs.sharpapi.io/en/api-reference/events-by-id"
}
}401 Unauthorized
Se nenhuma chave for enviada, retorna missing_api_key; uma chave inválida retorna invalid_api_key.
{
"error": {
"code": "missing_api_key",
"message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.",
"docs": "https://docs.sharpapi.io/en/authentication"
}
}Casos de UsoLink permanente para esta seção
- Comparação entre books — O
idcanô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_idspara direcionar usuários à página do evento de um sportsbook específico
Endpoints RelacionadosLink permanente para esta seção
- 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