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.

The API is in controlled beta. REST coverage is football-first; 19 product-verified bookmakers are available across REST and live plans. 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