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:
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
schemafield; schema changes are append-only. - Monetary amounts (where present) are integer cents.
Next
- Authentication — API keys & scopes
- Plan limits — what each plan includes
- REST API · WebSocket · Webhooks
Questions? Talk to us. Pre-launch — endpoints illustrate the shape of the API.