Real-time and pre-match odds data from Superbet covering soccer, basketball, and tennis. Live events, league markets, and structured JSON output — typically updated every 2–3 seconds.
## What you get
- **Live odds**: in-play markets split by sport (soccer, basketball, tennis)
- **Pre-match odds**: full market depth for upcoming events, split by sport
- **Multiple sports**: soccer, basketball, tennis
- **League data**: structured by competition (SuperLiga, NBA, ATP, and others)
- **Refresh rate**: every 2–3 seconds on average
## Endpoints
- `GET /v1/files` — list datasets available on your subscription
- `GET /v1/data/{filename}` — fetch the full JSON payload of a dataset
## Authentication
## Rate limits
Each plan has its own rate limit and quota — see Pricing. The origin may also return `429 Too Many Requests` if you exceed 10 requests per second. Use a short backoff or throttle.
## Data freshness
Files are updated continuously, typically every 2–3 seconds during active hours. Live data refreshes faster than pre-match data. There is no guaranteed SLA — freshness depends on Superbet's own publication cadence.
## Important notes
This API exposes publicly available odds aggregated from Superbet. Prices reflect scrape time and may differ from the current site. For informational and analytical use only; it does not place bets. Superbet is a trademark of Superbet Group; this API is not affiliated with or endorsed by Superbet.
Send your JoJ API key in the `X-JoJAPI-Key` header. The gateway authenticates the request and forwards it to the origin. `Authorization: Bearer` is also accepted.
## Available datasets
- `site_live_superbet_soccer.json` — live in-play soccer events
- `site_live_superbet_basketball.json` — live in-play basketball events
- `site_live_superbet_tennis.json` — live in-play tennis events
- `site_pregame_superbet_soccer.json` — upcoming soccer markets
- `site_pregame_superbet_basketball.json` — upcoming basketball markets
- `site_pregame_superbet_tennis.json` — upcoming tennis markets