Developers

Integrate in one sitting

RESTful endpoints, API key auth, and tenant docs generated on signup. Code at midnight, ship by dawn.

Authentication

Pass your tenant API key via the X-Api-Key header or ?apiKey= query parameter.

curl example
curl -H "X-Api-Key: YOUR_KEY" \
  https://odds.cafe/api/v1/tenant/odds/live?sport=cricket

Core endpoints

All tenant routes live under /api/v1/tenant/

Live odds

GET /odds/live — current prices with sport and market filters.

Events

GET /events — upcoming and in-play fixtures across supported sports.

Scorecard

GET /scorecard/:eventId — live match state and period breakdowns.

Bootstrap

GET /bootstrap — sports list, feature flags, and connection hints for your client.

Usage

GET /usage — quota consumption and billing period stats for your tenant.

Plans

GET /plans — public plan catalog (also powers this site’s pricing page).

“Good docs are like good coffee — strong, simple, and available when you need them.”
— Developer experience

Your personal docs

After onboarding, full integration guides are generated in your tenant lounge — with your API key pre-filled.

Open lounge & docs