Sharp planı · REST · JSON

API dokümantasyonu

Panelindeki veriler, aynı filtrelerle JSON olarak (senin bahis sitelerin; yoksa ülkendeki ve uluslararası siteler): son taramanın fırsatları (dakikada bir tarama), surebet'ler, kombineler ve her maçın adil olasılıkları (her 5 dakikada bir güncellenir). Temel URL: https://proba.bet.

Kimlik doğrulama

Ayarlar → API'den bir anahtar oluştur (Sharp planı, en fazla 3 aktif anahtar). Anahtarı Authorization: Bearer başlığında gönder. ?api_key= parametresi elektronik tablolar için kabul edilir ama önerilmez: anahtar bu durumda günlüklere ve geçmişe düşer. Anahtar bir kez gösterilir; yalnızca SHA-256 özetini saklarız.

curl -H "Authorization: Bearer pb_live_xxxxxxxx" "https://proba.bet/api/v1/me"

{ "plan": "sharp", "daily_limit": 20000, "remaining_today": 19999 }

Kota

Anahtar başına günde 20.000 istek (UTC), 00:00 UTC'de sıfırlanır. Her başarılı yanıt X-RateLimit-Limit ve X-RateLimit-Remaining taşır (429 yanıtı da, Retry-After ile birlikte). Fırsatlar en fazla dakikada bir değişir (İngiliz bahis sitelerinin oranları: 1–2 dakikada bir), maç olasılıkları 5 dakikada bir: daha sık sorgulamak anlamsızdır.

Uç noktalar

Örnek: value bet'ler

curl -H "Authorization: Bearer pb_live_xxxxxxxx" \
  "https://proba.bet/api/v1/opportunities?kind=value&min_ev=0.02&sport=soccer_epl&limit=50"

{
  "kind": "value", "count": 12, "generated_at": "2026-09-19T21:03:44.120Z",
  "data": [{
    "event_id": "0ab3…", "sport_key": "soccer_epl", "home": "Arsenal", "away": "Chelsea", "commence_time": "2026-09-20T15:00:00+00:00",
    "market_key": "h2h", "outcome": "Draw", "point": null,
    "book": "unibet_fr", "book_title": "Unibet (FR)", "price": 3.60, "link": "https://…",
    "fair_prob": 0.2914, "fair_odds": 3.43, "ev": 0.0490, "ev_expected": 0.0294, "kelly": 0.0113, "grade": "A", "flags": [],
    "alt_books": [{ "book": "betclic_fr", "price": 3.55, "ev": 0.0344, "ev_expected": 0.0206, "grade": "A" }],
    "first_seen": "2026-09-19T21:01:40+00:00", "published_at": "2026-09-19T21:02:41+00:00"
  }]
}

Yalnızca senin bahis sitelerinde (Ayarlar) oynanabilen bahisler döndürülür — site seçmediysen ülkendeki ve uluslararası sitelerde oynanabilenler —; bir surebet için tüm ayakları. book / price / ev tüm bahis siteleri arasındaki en iyi teklifi gösterir: kendi siteni book veya alt_books içinden seç. grade A = Babeth'in seçimi (herkese açık geçmiş performansta takip edilir); B = işaretlerle yayınlanır; C = oynamadan önce kontrol et. ev_expected = avantajın kapanışta beklenen kısmı (miktarın temeli); kelly = ev_expected üzerinden tam Kelly; published_at = tarama saati; first_seen = ilk görülme. Tarihler ISO 8601 UTC biçimindedir.

Örnek: maç olasılıkları

curl -H "Authorization: Bearer pb_live_xxxxxxxx" "https://proba.bet/api/v1/matches?sport=soccer_epl&hours=48"
curl -H "Authorization: Bearer pb_live_xxxxxxxx" "https://proba.bet/api/v1/matches?id=0ab3c9d1"

Hatalar

• 400 — geçersiz parametre (kind, id, sport)
• 401 missing_or_invalid_api_key — Authorization başlığı eksik veya anahtar hatalı biçimde
• 401 unknown_api_key — anahtar bilinmiyor veya iptal edilmiş
• 403 plan_required:sharp — anahtarın hesabı Sharp planında değil
• 429 daily_quota_exceeded — günlük kota doldu — 00:00 UTC'de sıfırlanır
• 500 internal_error — dahili hata, yeniden dene
• 503 upstream_unavailable — veriler geçici olarak kullanılamıyor (/matches), bir dakika sonra yeniden dene

Webhook'lar

API'yi sürekli sorgulamak yerine Babeth'in seni aramasına izin ver: Ayarlar → Webhook'ta herkese açık bir HTTPS URL gir ve “Uyarıları etkinleştir” seçeneğini açık bırak. Senin bahis sitelerindeki her yeni seçim bahsi (uyarılarınla aynı filtreler, sessiz saatler dahil) miktarınla birlikte POST edilir. Başarısız bir çağrı (zaman aşımı, 2xx dışı kod, yönlendirme) bir sonraki taramada yeniden denenir; 5 başarısızlıktan sonra gönderim 10 dakika duraklatılır. Aynı bahis istisnai olarak iki kez gelebilir: event_id + market_key + outcome + point üzerinden tekilleştir.

POST https://example.com/proba          (Settings → Webhook)
Content-Type: application/json
X-Proba-Event: picks | test
X-Proba-Signature: sha256=<HMAC-SHA256(secret, body)>

{
  "event": "picks", "sent_at": "2026-09-20T09:00:12Z", "user_id": "…",
  "picks": [{
    "event_id": "0ab3…", "sport_key": "soccer_epl", "home": "Arsenal", "away": "Chelsea", "commence_time": "2026-09-20T15:00:00Z",
    "sport_title": "EPL", "market_key": "h2h", "outcome": "Draw", "point": null,
    "book": "unibet_fr", "book_title": "Unibet (FR)", "price": 3.60, "link": "https://…", "book_url": "https://…",
    "fair_prob": 0.2914, "fair_odds": 3.43, "min_odds": 3.50, "ev": 0.049, "ev_expected": 0.0294, "grade": "A",
    "stake": 3, "currency": "EUR", "exchange": null
  }]
}

Mesaja güvenmeden önce imzayı doğrula:

# Node.js
const sig = req.headers["x-proba-signature"];            // "sha256=…"
const mac = crypto.createHmac("sha256", SECRET).update(rawBody).digest("hex");
const a = Buffer.from(sig || ""), b = Buffer.from("sha256=" + mac);
const ok = a.length === b.length && crypto.timingSafeEqual(a, b);

# Python
ok = hmac.compare_digest(sig, "sha256=" + hmac.new(SECRET.encode(), raw_body, hashlib.sha256).hexdigest())

5 saniye içinde, yönlendirme yapmadan 2xx yanıtı ver. `test` olayı “Test gönder” butonundan gelir.

Koşullar

Kişisel kullanım veya kendi araçların için. Verilerin yeniden satışı yok, herkese açık yeniden dağıtım yok. Anahtarlar Ayarlar'dan istediğin zaman iptal edilebilir. Karar destek verisi, kazanç garantisi yok.