Quickstart - apinn

1. Get your API key

Create an account on apinn.io — your key (pnk_…) works right away (250 req/h to test) and is displayed in your account area. Subscribe to a plan (2-day trial) to unlock the full quota — 1,000 to 20,000 req/h depending on the plan.

2. Make your first request

Pass the key in the X-API-Key header on every call.

# Complete odds history for an event
curl https://api.apinn.io/api/odds \
  -H "X-API-Key: YOUR_KEY" \
  -G --data-urlencode "event_id=1608247913" \
     --data-urlencode "full_history=1"

import requests

BASE = "https://api.apinn.io"
H = {"X-API-Key": "YOUR_KEY"}

r = requests.get(f"{BASE}/api/odds",
    params={"event_id": 1608247913, "full_history": 1}, headers=H)
odds = r.json()
print(f"{len(odds)} odds movements")

const BASE = "https://api.apinn.io";
const H = { "X-API-Key": "YOUR_KEY" };

const r = await fetch(`${BASE}/api/odds?event_id=1608247913&full_history=1`, { headers: H });
const odds = await r.json();
console.log(`${odds.length} odds movements`);

3. Explore the book

# List sports
curl https://api.apinn.io/api/sports -H "X-API-Key: YOUR_KEY"

# Live matches for a sport (29 = Soccer)
curl "https://api.apinn.io/api/fixtures?sport_id=29&live=1" -H "X-API-Key: YOUR_KEY"

# Main odds for a match
curl "https://api.apinn.io/api/odds?event_id=1608247913&main_lines_only=1" -H "X-API-Key: YOUR_KEY"

Every response returns quota headers: X-Quota-Limit, X-Quota-Remaining, X-Quota-Cost. See Rate limits.

Next steps

API Reference

All endpoints and parameters.

Real-time stream

Receive deltas pushed via SSE.