Eventos del partido

Marcadores derivados de baloncesto y tenis para un partido, junto al historial de precios de +EV History.


GET /api/v1/historical/match-events

Se requiere Enterprise. Usa la función history, igual que /api/v1/ev/history. Los planes inferiores reciben 403 tier_restricted.

Parámetros de consultaEnlace permanente a esta sección

Parameter	Type	Description
`game_id`	string	Obligatorio. El mismo ID de partido que `/api/v1/ev/history`.
`until`	string	Fecha RFC 3339 o segundos Unix. Por defecto, ahora; los valores futuros se limitan a ahora. Solo incluye observaciones hasta este 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'

RespuestaEnlace permanente a esta sección

Respuesta ilustrativa de baloncesto; los ID y las horas son ejemplos.


{
  "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 y servicioEnlace permanente a esta sección

Baloncesto: inicio, final de periodo y racha de puntos sin respuesta. Tenis: rotura de servicio y final de set.

Field	Description
`events[].t`	Hora de observación UTC (RFC 3339, con fracciones de segundo opcionales).
`events[].kind`	`tip`, `period_end`, `run`, `break`, `set_end`
`events[].label`	Etiqueta breve; por ejemplo `TIP`, `Q1 end`, `8-0`, `BRK`, `SET`.
`events[].side`	`home`, `away` o cadena vacía para un evento neutral.
`serve`	Solo tenis: intervalos con `t0`, `t1`, `server`. En un desempate se incluye `tiebreak: true` y `server` identifica al primer sacador. Otros deportes devuelven `[]`. La inferencia del servicio y las roturas depende de marcadores muestreados; no es una fuente oficial de servicio punto por punto.

Metadatos y resultados vacíosEnlace permanente a esta sección

Field	Description
`meta.game_id`	ID de partido solicitado.
`meta.as_of`	Límite efectivo en UTC.
`meta.sport` / `meta.supported`	Se admiten `basketball` y `tennis`. Otros deportes devuelven `supported: false` y listas vacías. Sin filas, `sport` está vacío y `supported` es falso.
`meta.snapshots`	Número de muestras utilizadas. Sin filas devuelve `200`, `snapshots: 0` y listas vacías; no demuestra que no pasó nada.
`meta.available`	`false` si el lector de historial no está disponible; también devuelve un `200` vacío. Un fallo de consulta devuelve `500 upstream_error`.
`meta.truncated`	Indica si el límite de filas truncó el historial.
`meta.serve_inferred`	Indica si el servicio de tenis pudo inferirse desde un primer sacador conocido.
`meta.sampling` / `meta.max_lag_seconds`	Descripción del muestreo e indicador nominal del retraso; consulte los límites.

Límites de los tiempos de observaciónEnlace permanente a esta sección

Son marcadores derivados de cambios muestreados, no tiempos de jugada a jugada. Indican cuándo SharpAPI observó un cambio, no cuándo ocurrió en la fuente. max_lag_seconds es un indicador nominal del retraso, no una garantía de latencia. Los cambios que se anulan entre muestras pueden no detectarse.

ErroresEnlace permanente a esta sección

400 validation_error si falta game_id, su formato es inválido o until es inválido. Se aplican la autenticación por API key y los límites de solicitudes habituales.