Introduction

The FirstBuzzer API gives you real-time and historical sports scoring for every game we cover — collected in the venue and consensus-verified. The same event schema is used across REST, WebSocket, and webhooks, so your backtests match production byte-for-byte.

Base URL

All requests go to https://api.firstbuzzer.com/v1 over HTTPS.

Quickstart

Authenticate with a bearer key, then pull today's eligible games:

bash
curl "https://api.firstbuzzer.com/v1/games?sport=nba&date=today" \
  -H "Authorization: Bearer $FB_API_KEY"

Then stream confirmed events for one of them over WebSocket, or register a webhook to have them pushed to you.

Conventions

  • Successful responses are wrapped in { "data": ... }; errors in { "error": { "code", "message" } }.
  • All timestamps are ISO 8601 in UTC, millisecond precision.
  • IDs are opaque, type-prefixed strings (e.g. nba_401766, evt_...).
  • Every event carries a schema field; schema changes are append-only.
  • Monetary amounts (where present) are integer cents.

Next

Questions? Talk to us. Pre-launch — endpoints illustrate the shape of the API.