Real-time and pre-match odds data from Stoiximan 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 across major Stoiximan events
- **Pre-match odds**: full market depth for upcoming events
- **Multiple sports**: soccer, basketball, tennis
- **League data**: structured by competition (Super League, 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
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_stoiximan.json` — all live in-play events
- `site_pregame_stoiximan_soccer.json` — upcoming soccer markets
- `site_pregame_stoiximan_basketball.json` — upcoming basketball markets
- `site_pregame_stoiximan_tennis.json` — upcoming tennis markets
## 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 Stoiximan's own publication cadence.
## Important notes
This API exposes publicly available odds aggregated from Stoiximan. Prices reflect scrape time and may differ from the current site. For informational and analytical use only; it does not place bets. Stoiximan is a trademark of Kaizen Gaming; this API is not affiliated with or endorsed by Stoiximan.