Eventos da partida

Marcadores derivados de basquete e tênis para uma partida, junto ao histórico de preços em +EV History.


GET /api/v1/historical/match-events

Requer Enterprise. Usa o recurso history, como /api/v1/ev/history. Planos inferiores recebem 403 tier_restricted.

Parâmetros de consultaLink permanente para esta seção

Parameter	Type	Description
`game_id`	string	Obrigatório. O mesmo ID de partida de `/api/v1/ev/history`.
`until`	string	Data RFC 3339 ou segundos Unix. O padrão é agora; valores futuros são limitados a agora. Inclui apenas observações até esse instante.


curl -G 'https://api.sharpapi.io/api/v1/historical/match-events' \
  -H 'X-API-Key: YOUR_API_KEY' \
  --data-urlencode 'game_id=YOUR_GAME_ID' \
  --data-urlencode 'until=2026-10-22T00:01:00Z'

RespostaLink permanente para esta seção

Resposta ilustrativa de basquete; IDs e horários são exemplos.


{
  "success": true,
  "events": [
    {
      "t": "2026-10-22T00:00:00Z",
      "kind": "tip",
      "label": "TIP",
      "side": ""
    }
  ],
  "serve": [],
  "meta": {
    "game_id": "example-game-id",
    "sport": "basketball",
    "supported": true,
    "as_of": "2026-10-22T00:01:00Z",
    "snapshots": 2,
    "truncated": false,
    "available": true,
    "serve_inferred": false,
    "sampling": "event times are when SharpAPI observed a scoreboard change, so they can lag the real event, and a change that cancels out between two observations is not seen",
    "max_lag_seconds": 30
  }
}

Campos de eventos e saqueLink permanente para esta seção

Basquete: início, fim de período e sequência de pontos sem resposta. Tênis: quebra de saque e fim de set.

Field	Description
`events[].t`	Horário de observação UTC (RFC 3339, possivelmente com frações de segundo).
`events[].kind`	`tip`, `period_end`, `run`, `break`, `set_end`
`events[].label`	Rótulo curto; por exemplo `TIP`, `Q1 end`, `8-0`, `BRK`, `SET`.
`events[].side`	`home`, `away` ou string vazia para um evento neutro.
`serve`	Somente tênis: intervalos com `t0`, `t1`, `server`. No tiebreak, inclui `tiebreak: true` e `server` identifica o primeiro sacador. Outros esportes retornam `[]`. A inferência de saque e quebras depende de placares amostrados; não é um feed oficial de saque ponto a ponto.

Metadados e resultados vaziosLink permanente para esta seção

Field	Description
`meta.game_id`	ID da partida solicitado.
`meta.as_of`	Limite efetivo em UTC.
`meta.sport` / `meta.supported`	Suporta `basketball` e `tennis`. Outros esportes retornam `supported: false` e listas vazias. Sem linhas, `sport` é vazio e `supported` é falso.
`meta.snapshots`	Número de snapshots usados. Sem linhas retorna `200`, `snapshots: 0` e listas vazias; isso não demonstra que nada aconteceu.
`meta.available`	`false` quando o leitor de histórico está indisponível; também retorna um `200` vazio. Falha de consulta retorna `500 upstream_error`.
`meta.truncated`	Indica se o limite de linhas truncou o histórico.
`meta.serve_inferred`	Indica se o saque de tênis pôde ser inferido a partir de um primeiro sacador conhecido.
`meta.sampling` / `meta.max_lag_seconds`	Explicação da amostragem e indicador nominal de atraso; veja os limites abaixo.

Limites dos horários de observaçãoLink permanente para esta seção

São marcadores derivados de mudanças amostradas do placar, não horários de cada jogada. Registram quando a SharpAPI observou uma mudança, não quando ocorreu na fonte. max_lag_seconds é um indicador nominal de atraso, não uma garantia de latência. Mudanças que se anulam entre amostras podem não ser detectadas.

ErrosLink permanente para esta seção

400 validation_error se game_id estiver ausente/inválido ou until for inválido. Aplicam-se a autenticação por API key e os limites de requisições habituais.