Question 1

What does this API provide?

Accepted Answer

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.

Question 2

How do I authenticate?

Accepted Answer

Use your JoJ API key. The recommended header is X-JoJAPI-Key: YOUR_API_KEY. Authorization: Bearer YOUR_API_KEY also works.

Question 3

Which datasets can I download?

Accepted Answer

site_live_stoiximan.json (all live events) plus site_pregame_stoiximan_soccer.json, site_pregame_stoiximan_basketball.json, and site_pregame_stoiximan_tennis.json.

Question 4

How fresh is the data?

Accepted Answer

Scrapers typically refresh every 2–3 seconds during active hours. Live markets update faster than pre-match. There is no guaranteed SLA.

Question 5

What is the rate limit?

Accepted Answer

Plan limits are on the Pricing tab. The origin may also return 429 above 10 requests per second. Throttle or back off briefly.

Question 6

Is this an official Stoiximan API?

Accepted Answer

No. It aggregates publicly displayed Stoiximan odds. It is not affiliated with or endorsed by Stoiximan or Kaizen Gaming.

Question 7

Can I place bets through this API?

Accepted Answer

No. Odds are for informational and analytical use only (arbitrage research, line shopping, modeling). It does not place bets.

Question 8

What does a successful response look like?

Accepted Answer

JSON with company, key_id, file, and data (the dataset payload). Call /v1/files first if you are unsure which filename to request.

Stoiximan Odds

Frequently Asked Questions