Developer Portal
betspread Developer Portal
Reference documentation for the betspread bookmaker odds API. REST endpoints are read-only HTTP GET under https://api.betspread.io/api/v1; Live is a separate WebSocket product channel gated by plan and bookmaker entitlement.
Get started
Quickstart →
Run your first request in under five minutes.
Get started
Authentication →
Bearer and X-Api-Key headers. Where to get your key and how to rotate it.
Endpoint
Event odds →
Grouped odds for one event across markets and bookmakers.
Live product
Live WebSocket →
Authentication, channel format, subscription, replay, errors, and usage metering.
Reference
API reference →
Generated reference from the same OpenAPI contract served at /api/v1/spec.
Endpoint
Bookmakers →
Entitled bookmaker sources with REST and live capability metadata.
Reference
Errors →
Error response shape and the complete list of error codes.
Reference
Rate limits →
X-RateLimit-* headers and 429 backoff guidance.
Guides
Guide
Python →
Fetch odds with requests, paginate events, handle errors and 429 rate limits.
Guide
JavaScript / TypeScript →
Typed Node.js client on fetch with pagination, error codes and Retry-After.
Guide
Live odds WebSocket →
Connect, subscribe, replay from a sequence and reconnect with backoff.
Guide
Google Sheets →
Apps Script pulls odds into a sheet on a trigger, key in Script Properties.
The API is in controlled beta. REST coverage is football-first; currently 0 product-verified bookmakers are available across REST and live plans while every source is under review. See Coverage for the current bookmaker list.
Beta access
Need an API key? Request beta access and we will reach out with your bookmaker, sport, market, and region scope.
Request beta access