Skip to Content
Referência da APIDetalhes do Evento

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âmetroTipoObrigatórioDescrição
eventIdstringSimIdentificador ú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:

HeaderDescrição
X-RateLimit-LimitMáximo de requisições por minuto para o seu tier
X-RateLimit-RemainingRequisições restantes na janela atual
X-RateLimit-ResetTimestamp Unix de quando a janela de rate limit é reiniciada
X-Data-DelayAtraso de dados para o seu tier (ex.: 0s, 60s)
X-Request-IdIdentificador único da requisição para depuração

Objeto de Detalhes do EventoLink permanente para esta seção

CampoTipoDescrição
idstringIdentificador 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_idsobjectMapa 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.
sportstringIdentificador do esporte (ex.: basketball, football)
leaguestringNome da liga (ex.: NBA, NFL)
home_teamstringNome do time da casa
away_teamstringNome do time visitante
start_timestringHorá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_atstringHorário de conclusão em ISO 8601. Presente apenas em linhas com status: "final".
statusstringStatus 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_livebooleanSe o jogo está ao vivo: true quando status é live.
live_book_countintegerQuantas 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_typestring"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_groupstringNome 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_slugstringevent_group em formato seguro para URL (ex.: ufc-fight-night). Presente exatamente quando event_group estiver.
booksarraySportsbooks que cobrem este evento, ordenados por contagem de mercados em ordem decrescente
marketsarrayTipos de mercado disponíveis para este evento, ordenados por contagem de seleções em ordem decrescente
last_seenobjectPresente 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.
resultobjectPresente apenas quando status é final e sua chave tem o add-on Game State ou o tier Enterprise. O resultado final, descrito abaixo.
result_accessstringPresente 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.
sourcestringconfirmed 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.

CampoTipoDescrição
idstringIdentificador do sportsbook (ex.: draftkings, pinnacle)
namestringNome de exibição do sportsbook
market_countintegerNúmero de tipos de mercado distintos que este book oferece para o evento
last_updatestringTimestamp 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.

CampoTipoDescrição
typestringIdentificador do tipo de mercado (ex.: moneyline, spread, total, player_prop)
selection_countintegerNúmero de seleções distintas disponíveis neste mercado
book_countintegerNú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.

CampoTipoDescrição
home_scoreintegerPlacar do time da casa no último frame visto. Um número de sets quando score_type é sets
away_scoreintegerPlacar do time visitante no último frame visto. Um número de sets quando score_type é sets
score_typestringsets para tênis, tênis de mesa, vôlei e badminton; points para todos os outros esportes
game_periodstringPeríodo no último frame visto (ex.: Q4). Omitido quando o feed não enviou nenhum
game_clockstringRelógio de jogo no último frame visto (ex.: 4:59). Omitido quando o feed não enviou nenhum
seen_atstringHorá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.

CampoTipoDescrição
event_idstringO identificador do evento
sportstringIdentificador do esporte
leaguestringSlug da liga
home_teamstringNome do time da casa
away_teamstringNome do time visitante
final_home_scoreintegerPlacar final do time da casa. Um número de sets quando score_type é sets
final_away_scoreintegerPlacar final do visitante. Um número de sets quando score_type é sets
winnerstringhome, away ou draw. Omitido quando o vencedor não pode ser determinado
score_typestringsets 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_scoresobjectPlacar 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_atstringO mesmo valor de completed_at do evento

Exemplos de RequisiçõesLink permanente para esta seção

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 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 RelacionadosLink permanente para esta seção

Last updated on