AlyBet API — Enterprise Integration

Quick Start — 3 Steps

1

Test now

curl https://alybet.io/api/v2/odds | jq '.matches[0]'

If you see JSON → API is working.

2

Integrate (copy-paste)

// alybet.js
const BASE = "https://alybet.io";

export async function getOdds(bookmaker) {
  const url = bookmaker
    ? `${BASE}/api/v2/odds?bookmaker=${bookmaker}`
    : `${BASE}/api/v2/odds`;
  const res = await fetch(url);
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return await res.json();
}

// Usage:
// const data = await getOdds();
// const winner = await getOdds("winner");

# alybet.py
import requests

BASE = "https://alybet.io"

def get_odds(bookmaker=None):
    params = {"bookmaker": bookmaker} if bookmaker else {}
    r = requests.get(f"{BASE}/api/v2/odds", params=params)
    r.raise_for_status()
    return r.json()

# Usage:
# data = get_odds()
# winner = get_odds("winner")

3

Poll correctly (important)

Poll every 10–30s. Check version — process only when it changes.

let lastVersion = 0;
setInterval(async () => {
  const data = await (await fetch('https://alybet.io/api/v2/odds')).json();
  if (data.version !== lastVersion) {
    lastVersion = data.version;
    // process data.matches
  }
}, 15000);

Endpoint Decision Table

Endpoint	When to use	Status
/api/v2/odds	Production — all new integrations	REQUIRED
/api/odds	Legacy clients only	DEPRECATED
/api/capabilities	Startup discovery	OPTIONAL
/health	Monitoring / uptime checks	OPTIONAL
/api/stats	Internal debugging	OPTIONAL

Response Format — /api/v2/odds

{
  "version": 8,
  "matches": [
    {
      "id": "superbet_11521552",
      "sport": "football",
      "bookmaker": "Superbet",
      "home": "Lech Poznan",
      "away": "Gornik Zabrze",
      "league": "Ekstraklasa",
      "odds": { "1": 2.10, "X": 3.40, "2": 3.20 },
      "start_time": 1772722800,
      "updated": 1770477003
    }
  ],
  "matches_count": 150
}

Field	Type	Notes
id	string	{bookmaker}_{source_id}
sport	string	Currently "football"
bookmaker	string	Betika, Superbet, or Winner
home / away	string	Team names (empty entries excluded)
league	string	"Unknown" if unavailable
odds	object	{"1": home, "X": draw, "2": away}
start_time	number\|null	Unix ts, null if unknown
updated	number	Unix ts of last data update

API Contract

Guarantees

Stable JSON schema
Documented fields only
Backward compat on /api/odds
Versioning via version field
No auth required

Non-guarantees

No WebSocket / push
No authentication tokens
No SLA (best-effort uptime)
Match count may vary
Bookmaker list may change

Production Checklist

Using /api/v2/odds (not v1)

Polling every 10–30 seconds

Retry on 500/504 with exponential backoff

Caching by version field

Calling /api/capabilities at startup

Downloads

Import Postman collection for instant endpoint testing. Sample JSON for local dev without API calls.

Error Handling

HTTP	Meaning	Action
200	Success	Process response
404	Not found	Check /api/capabilities
500	Server error	Retry with exponential backoff
504	Timeout	Retry after 5s

AlyBet Odds API — Enterprise Integration