Endpoints
Ungrouped Endpoints 2
What is the Stoiximan Odds API?
Stoiximan (Betano Greece) odds as JSON: every in-play sport, pre-match soccer, basketball and tennis, plus 15 major soccer leagues. Updated every few seconds.
Stoiximan Odds API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.
Stoiximan Odds API endpoints
- GET
/v1/data/{filename}$0.01 / callFetch dataset JSON
Returns one odds file inside an envelope: {"company", "file", "updated_at", "data"}. data is the bookmaker's own JSON, unchanged; updated_at is when the file was last refreshed (UTC). The same time is sent as the Last-Modified header — send it back as If-Modified-Since to get 304 Not Modified until the file changes. Request gzip: responses arrive about 6–10 times smaller. Errors (body {"detail": "…"}): 400 invalid filename · 401 missing or invalid API key · 403 unknown file or a file of another bookmaker · 404 file temporarily unavailable · 429 too many requests (see Retry-After) · 500 file temporarily invalid.
- GET
/v1/files$0.01 / callList available datasets
Lists the odds files your subscription can read, sorted by name. Returns {"company", "count", "files"}. Call it first and request only the names it returns.
Frequently asked questions about Stoiximan Odds API
What does this API provide?
Structured JSON feeds of Stoiximan live and pre-match odds for soccer, basketball, and tennis. Call GET /v1/files to list datasets, then GET /v1/data/{filename} to download one.
How do I authenticate?
Use your JoJ API key. The recommended header is X-JoJAPI-Key: YOUR_API_KEY. Authorization: Bearer YOUR_API_KEY also works.
Which datasets can I download?
site_live_stoiximan.json (all live events) plus site_pregame_stoiximan_soccer.json, site_pregame_stoiximan_soccer_leagues.json, site_pregame_stoiximan_basketball.json, and site_pregame_stoiximan_tennis.json.
How fresh is the data?
Live odds refresh about every 2–5 seconds; pre-match files about every 6–10 seconds. Each response carries updated_at (last refresh, UTC). There is no guaranteed SLA.
What is the rate limit?
Plan limits are on the Pricing tab. The origin may also return 429 above 10 requests per second. Throttle or back off briefly.
Is this an official Stoiximan API?
No. It aggregates publicly displayed Stoiximan odds. It is not affiliated with or endorsed by Stoiximan or Kaizen Gaming.
Can I place bets through this API?
No. Odds are for informational and analytical use only (arbitrage research, line shopping, modeling). It does not place bets.
What does a successful response look like?
JSON envelope with company, file, updated_at (last refresh, UTC; also sent as Last-Modified — send If-Modified-Since to get 304 until it changes) and data (the bookmaker's own JSON, unchanged). Request gzip: responses are about 6–10 times smaller. Call /v1/files first if you are unsure which filename to request.