Dokumentacja ArbiScan API

v1 · base URL https://api.arbiscan.pl · wszystkie odpowiedzi w formacie application/json; charset=utf-8

Jak zacząć

1. Złóż wniosek o dostęp — podaj e-mail, hasło i opis planowanego użycia.
2. Poczekaj na zatwierdzenie konta przez administratora (otrzymasz wiadomość e-mail).
3. Zaloguj się do panelu klienta i wygeneruj klucz API.
4. Dodaj nagłówek X-API-Key do zapytań HTTPS.

Uwierzytelnianie

Wszystkie endpointy danych wymagają klucza API w nagłówku X-API-Key (poza /v1/health):

curl -H "X-API-Key: ods_xxxxxxxxxxxx" \
  "https://api.arbiscan.pl/v1/odds?league=Premier%20League"

Klucze API są niezależne od kont na arbiscan.pl. Pojedyncze konto może mieć do 5 kluczy (np. produkcja / test / staging).

Limity i kwoty

Domyślne limity klucza:

• 60 zapytań / minutę — przekroczenie zwraca 429 Too Many Requests.
• 10 000 zapytań / dzień (UTC) — kwota resetuje się o 00:00 UTC.

Limity per-klucz konfigurujesz w panelu przy tworzeniu lub edycji klucza. Aktualne zużycie raportują endpointy /v1/usage oraz pole quota w odpowiedzi /v1/odds.

Dostępność danych

Wspierane bukmacherzy: większość legalnych polskich bukmacherów (STS, Fortuna, Superbet, Betclic, LvBet, Betfan, Etoto, Iforbet, Fuksiarz i inne) oraz kasyna krypto (Polymarket, 500.casino, Gamdom). Możliwa integracja niestandardowych źródeł kursowych na zamówienie — napisz na kontakt@arbiscan.pl.

Typowe opóźnienia w pełnym cyklu skanowania to ~60 s; pojedyncze zapytania per-event idą praktycznie natychmiast. Dokładne czasy zależą od bukmachera (informacje SLA na życzenie).

Endpointy publiczne

{ "ok": true, "events_known": 312, "last_ingest": "2026-05-04T11:48:00Z" }

{ "sports": ["Football"] }

{ "leagues": ["Premier League", "La Liga", "Serie A", "Bundesliga", "MLS", ...] }

{ "bookmakers": ["Betclic", "Betfan", "Etoto", "Fortuna", "Fuksiarz", "Iforbet", "LvBet", "Polymarket", "Sts", "Superbet", ...] }

curl -H "X-API-Key: $KEY" \
  "https://api.arbiscan.pl/v1/odds?league=Premier%20League&bookmakers=STS,Fortuna,Superbet,Betclic,LvBet"

{
  "count": 8,
  "events": [
    {
      "id": "a1b2c3d4e5f60718",
      "sport": "Football",
      "league": "Premier League",
      "home_team": "Manchester City",
      "away_team": "Arsenal",
      "commence_time": "2026-05-10T21:00:00+00:00",
      "bookmakers": [
        {
          "key": "Sts",
          "last_update": "2026-05-04T11:48:00+00:00",
          "markets": [
            { "key": "h2h", "outcomes": [
              { "name": "Manchester City", "price": 1.85 },
              { "name": "Draw",            "price": 3.75 },
              { "name": "Arsenal",         "price": 4.10 }
            ] }
          ]
        }
      ]
    }
  ],
  "quota": { "used": 12, "limit": 10000 }
}

{
  "event_id": "a1b2c3d4e5f60718",
  "market": "h2h",
  "history": [
    { "bookmaker": "Sts", "outcome": "Manchester City", "price": 1.90, "timestamp": "2026-05-04T08:12:45+00:00" },
    { "bookmaker": "Sts", "outcome": "Manchester City", "price": 1.88, "timestamp": "2026-05-04T09:20:11+00:00" },
    { "bookmaker": "Sts", "outcome": "Manchester City", "price": 1.85, "timestamp": "2026-05-04T11:48:00+00:00" }
  ]
}

{
  "owner": "twoja-nazwa",
  "today": { "used": 124, "limit": 10000 },
  "history": [
    { "date": "2026-05-04", "requests": 124 },
    { "date": "2026-05-03", "requests": 8431 }
  ]
}

Rejestracja i logowanie

{
  "email": "ty@firma.pl",
  "password": "min. 8 znaków",
  "application": "własny model predykcyjny",
  "planned_use": "Codzienne pobieranie kursów PL/LL/SerieA, ~5000 zapytań/dzień, brak redystrybucji.",
  "requested_daily_limit": 5000
}

{ "email": "ty@firma.pl", "password": "..." }
→
{ "token": "eyJhbGc...", "user": { "id": 12, "email": "ty@firma.pl", "is_admin": false }, "expires_in": 604800 }

Zarządzanie kluczami

Wszystkie endpointy /v1/me/* wymagają nagłówka Authorization: Bearer <token> z logowania.

Kody błędów

Schemat odpowiedzi

• event_id = stabilny hash z (liga, posortowana_para_drużyn, data_kickoffu). Ten sam mecz u STS i Fortuny daje ten sam event_id, jeśli normalizacja nazw drużyn się zgadza.
• Nazwy wyników w 1X2 są normalizowane do pełnej nazwy drużyny dla "1" / "2" oraz dosłownego Draw dla "X".
• Klucz rynku dla 1X2 to h2h (head-to-head, zgodny z konwencją The-Odds-API).
• Znaczniki czasu w formacie ISO 8601 z jawnym offsetem UTC.

Wspierany zakres i rozszerzalność

API jest zaprojektowane pod elastyczne dostosowanie do potrzeb klienta:

• Bukmacherzy — większość legalnych polskich bukmacherów (STS, Fortuna, Superbet, Betclic, LvBet, Betfan, Etoto, Iforbet, Fuksiarz i inne) oraz kasyna krypto (Polymarket, 500.casino, Gamdom). Niestandardowe źródła kursowe integrowane są na zamówienie.
• Rynki — wspierane są wszystkie popularne typy zakładów: 1X2 (Match Winner), Double Chance, Both Teams To Score, Over/Under (totals), Asian Handicap, Correct Score, Half-Time/Full-Time, Player Props, Cards/Corners totals, Multi Goals i inne. Zwracana struktura markets[] jest neutralna względem typu rynku — możemy emitować dowolny.
• Dyscypliny — piłka nożna, koszykówka, tenis, hokej, MMA/Boks, e-sport, futsal, krykiet, polityka (Polymarket) i inne. Wszystko, co skanują nasze backendy.
• Live i prematch — domyślnie prematch; live (z aktualizacją w trakcie meczu) na zamówienie.
• Niestandardowe limity — limity dzienne i per-minutę ustawiane indywidualnie per-konto / per-klucz.
• Custom shape — możemy dostosować strukturę odpowiedzi pod konkretne potrzeby (CSV, custom JSON, webhook push, WebSocket streaming).

Indywidualne wyceny i integracje: kontakt@arbiscan.pl.