Quickstart Guide

Step 1: Get your API key

Email [email protected] to request an API key. Free tier includes 60 requests/minute.

Step 2: Make your first request

# List all available sports
curl -H "Authorization: Bearer YOUR_KEY" \
  https://oddstatus.com/api/sports

# Get EPL events
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://oddstatus.com/api/events?sportKey=soccer_epl&limit=10"

# Get odds for a specific event
curl -H "Authorization: Bearer YOUR_KEY" \
  https://oddstatus.com/api/odds/evt_abc123

Step 3: Integrate

// JavaScript / TypeScript
const response = await fetch(
  'https://oddstatus.com/api/events?sportKey=basketball_nba&limit=10',
  { headers: { 'Authorization': 'Bearer YOUR_KEY' } }
);
const data = await response.json();
console.log(data.events);

Step 4: Webhooks (Pro)

Pro users can register webhook URLs to receive real-time odds updates via POST requests. Contact us for details.