Arbitraj bahsi için spor oranları API'si: etkinlikler, oranlar ve surebet'ler API ile
Kısaca
- Spor oranları API'si etkinlikleri, piyasaları ve her bahis şirketinin oranlarını son güncelleme zamanıyla döndürür. Ondalık oranın zımni olasılığı 1/k'dir; tahmin piyasasında YES kontratının dolar fiyatı da aynı olasılıktır.
- Bir piyasanın tüm sonuçları için en iyi oranların 1/k toplamı 1'den küçükse surebet vardır ve her bahis tutarı 1/k ile orantılıdır. Hataların çoğu eşleştirmede yapılır: maç, piyasa, periyot ve çizgi her platformda aynı olmalıdır.
- Pro ve Max planlarında
mode=sportile Genesis API, 13 platformdaki maç öncesi surebet'leri her bacak için birstake_unitile döndürür. Bahis şirketinin bahis limiti bilinmediği için bunlarınprofit_usddeğeri null'dır.
Spor oranları API'si, diğer adıyla spor bahis API'si, bir programa bahis çizgisini verir: etkinlikler, piyasalar ve her bahis şirketinin oranları, her fiyatın son güncellenme zamanıyla birlikte. Program bu verilerle platformlar arasındaki fiyatları karşılaştırır ve surebet'leri bulur. Surebet, bir maçın tüm sonuçlarına yapılan ve sonuç ne olursa olsun kârla biten bahislerdir; tek koşul, her bahsin aynı kurallarla kabul edilip sonuçlandırılmasıdır. Bu, arbitraj bahsidir ve Genesis API, mode=sport ile /predictions/arbitrage endpoint'i üzerinden 13 platformdaki hazır surebet'leri sunar.
Spor oranları API'si ne döndürür
Sağlayıcılar alanlara farklı adlar verir, ancak oran API'si çizgiyi beş düzeyde tanımlar. Periyot ve çizgi olmadan iki oran karşılaştırılamaz; zaman olmadan da fiyatın hâlâ geçerli olup olmadığı bilinemez. Sağdaki sütun açıklayıcı bir örnektir.
| Düzey | Ne içerir | Örnek |
|---|---|---|
| Etkinlik | Spor, turnuva, takımlar, başlangıç | Futbol, Bundesliga, Bayern — Dortmund |
| Piyasa | Bahis türü, periyot, çizgi | Toplam 2,5, normal süre |
| Sonuç | Bahsin yapıldığı seçenek | 2,5 üst |
| Fiyat | Her bahis şirketinin oranı | Fonbet @1,95, Winline @2,02 |
| Zaman | Fiyatın güncellendiği an | 12 saniye önce |
Oranlar ondalık, kesirli veya Amerikan formatında gelir; tahmin platformları ise oran yerine dolar cinsinden kontrat fiyatı verir. Veri, ya platformun kendi açık API'sinden ya da birçok bahis şirketinin çizgisini tek formatta toplayan bir sağlayıcıdan gelir. Polymarket ve Kalshi verileri Polymarket ve Kalshi API'leri yazısında anlatılıyor.
Oran, olasılık ve sent cinsinden fiyat
Ondalık oran, yatırılan her dolar için bahis tutarı dahil ne kadar geri döneceğini gösterir: @2,25 oranla 100 $, 225 $ olur. Karşılığı olan ters değer zımni olasılıktır: 1 / 2,25 = 0,4444 yani %44,44. Kesirli ve Amerikan oranları ondalığa Bahis oranları açıklandı yazısındaki formüllerle çevrilir.
| Fiyat | Ondalık oran | Olasılık |
|---|---|---|
| Bahis şirketinde @2,25 | 2,25 | %44,44 |
| Bahis şirketinde @3,60 | 3,60 | %27,78 |
| Polymarket'te 30¢'ten YES | 1 / 0,30 = 3,33 | %30 |
YES kontratı, sonucu gerçekleşirse 1 $ öder; dolar fiyatı da piyasanın olasılık tahminidir. «Bayern kazanır» için NO kontratı, Dortmund kazanırsa veya maç berabere biterse kazanır; çifte şans gibi.
Tek bir bahis şirketinde bir piyasanın tüm sonuçlarının olasılıkları toplamı 1'i aşar ve fazlalık şirketin marjıdır. Açıklayıcı örnek: Fonbet'in Bayern — Dortmund çizgisi 2,15 / 3,45 / 3,40, 0,46512 + 0,28986 + 0,29412 = 1,04910, yani %4,91 marj verir. Adım adım hesap Bahis şirketi marjı nasıl hesaplanır yazısında.
Oranlardan surebet nasıl bulunur
Surebet, bahis şirketleri arasındaki en iyi fiyatlardan bulunur: piyasanın her sonucu için en yüksek oran alınır ve 1/k'ler toplanır. Açıklayıcı örnek: aynı maç, normal süre maç sonucu piyasası.
| Sonuç | En iyi oran | Nerede | 1/k |
|---|---|---|---|
| 1, Bayern kazanır | @2,25 | Betcity | 0,44444 |
| X, beraberlik | @3,60 | Marathon | 0,27778 |
| 2, Dortmund kazanır | @3,80 | Winline | 0,26316 |
L = 0.44444 + 0.27778 + 0.26316 = 0.98538
Toplam 1'in altında, yani surebet var; kâr 1 / 0.98538 − 1 = 1.48%. Aşağıdaki kodda dört bahis şirketinin kendi çizgilerinde marj %3,8 ile %5,1 arasındadır; surebet, maçı birbirinden farklı fiyatlamalarından doğar.
Toplam bahis tutarı 1/k ile orantılı bölünür: 1.000 $'dan ev sahibi galibiyetine 1.000 × 0,44444 / 0,98538 = 451,04 $ gider; diğer tutarlar tabloda.
| Bahis | Tutar | Kazanırsa |
|---|---|---|
| Betcity · 1 @2,25 | 451,04 $ | 1.014,84 $ |
| Marathon · X @3,60 | 281,90 $ | 1.014,84 $ |
| Winline · 2 @3,80 | 267,06 $ | 1.014,83 $ |
Her sonuç yaklaşık 1.000 / 0,98538 = 1.014,84 $ getirir; en kötü durumdaki kâr, tutar yuvarlaması nedeniyle 14,83 $'dır.
Aynı mantık kodda, girdi olarak bir piyasanın dört bahis şirketindeki çizgisiyle:
# Açıklayıcı örnek: dört bahis şirketinde tek bir 1X2 piyasası çizgisi
line = {
"Fonbet": {"1": 2.15, "X": 3.45, "2": 3.40},
"Betcity": {"1": 2.25, "X": 3.20, "2": 3.40},
"Marathon": {"1": 2.05, "X": 3.60, "2": 3.50},
"Winline": {"1": 2.10, "X": 3.35, "2": 3.80},
}
def surebet(line, bank):
outcomes = next(iter(line.values())).keys()
# her sonuç için en iyi oran ve onu veren bahis şirketi
best = {o: max((odds[o], bk) for bk, odds in line.items())
for o in outcomes}
total = sum(1 / k for k, _ in best.values())
if total >= 1:
return None # surebet yok
for o, (k, bk) in best.items():
print(f"{o}: {bk} @{k} — ${bank / k / total:.2f}")
return round((1 / total - 1) * 100, 2)
print(surebet(line, 1000), "%") # 1.48 %
İki sonuçlu bir piyasada (handikap, toplamlar, iki takım da gol atar) sözlükte iki anahtar olur ve formül aynı kalır. Tutar yuvarlama ve oranlar değişince yeniden hesaplama, Surebet nasıl hesaplanır dersinde anlatılıyor.
Eşleştirme: aynı maç, piyasa, periyot ve çizgi
Formül ancak her fiyat aynı maçın aynı piyasasına aitse geçerlidir. Bahis şirketleri takım adlarını farklı yazar, başlangıç saatleri dakikalarla ayrışır, piyasaların kendi adları vardır. Eşleştirme hatası sahte surebet üretir: 1/k toplamı 1'in altında çıkar, ama sonuçlardan birinde tüm bahisler kaybeder.
| Neye bakılır | Nerede yanlış gider | mode=sport alanı |
|---|---|---|
| Maç ve kadro | Bayern — Bayern II, kadın veya genç takım | teams, flags |
| Başlangıç | Bir bahis şirketinde maç ertelenmiş | starts_at |
| Piyasa türü | Sonuç, handikap, toplam, BTTS, kesin skor | market_type |
| Periyot | Normal süre veya uzatmalı maç | period |
| Çizgi | −1,5 ve −1,25 handikapları farklı bahislerdir | line |
| Bacakların sonuçları | Bacaklar birlikte tüm sonuçları kapsamalı | legs[].covers |
Futbolda normal süre, 90 dakika artı eklenen süredir. Bahis platformları futbol ve hokeyde maç sonucunu, handikapları ve toplamları genellikle bu süreye göre sonuçlandırır; piyasa adında uzatma ve penaltılar dahil yazmıyorsa. Tahmin platformundaki kazanan piyasası uzatmayı içerebilir; o zaman normal süre beraberliği tüm çifti kaybettirebilir.
Handikap, aynı büyüklükteki zıt handikapla surebet oluşturur: ev sahibi −1,5 ve deplasman +1,5. −0,75 gibi bir çeyrek Asya handikapında bahis tutarı iki komşu çizgiye yarı yarıya bölünür; ev sahibi −0,75 ile deplasman +0,75 de tüm skorları kapsar. Toplamlar tek çizgide eşleşir: 2,5 üst ile 2,5 alt.
Ters çift, yani 2,5 üst ile 3,5 alt, bir middle'dır: üç golde iki bahis de kazanır. Genesis API'de line ve period tüm surebet için bir kez belirlenir; bu yüzden farklı çizgili bacaklar aynı satıra düşmez.
Genesis API ile surebet'ler: mode=sport
mode=sport ile /predictions/arbitrage endpoint'i, bu işin zaten yapıldığı surebet'leri döndürür: etkinlikler platformlar arasında eşleştirilir, en iyi fiyatlar seçilir ve tahmin platformu bacakları komisyonlarla birlikte emir defterinde yürütülür. 13 platform vardır: Polymarket, Kalshi, Predict.fun ve 10 bahis platformu: Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB ve Dafa Sports. Yalnızca maç öncesi: maç başlayınca surebet'i yanıttan çıkar.
Bu mod Pro (ayda 100 $, her 10 sn'de yeni snapshot) ve Max (200 $, her 5 sn'de) planlarına dahildir; Trial ve Start'ta istek 403 plan_restricted döndürür. API, her bahis şirketinin tam çizgisini vermez: yanıtta yalnızca bulunan surebet'ler, her bacağın platformu, sonucu ve fiyatıyla yer alır.
curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d mode=sport -d sport=soccer -d min_profit_pct=1.5
Açıklayıcı örnek: dokümantasyondan, fiyatları yeniden hesaplanmış bir mode=sport satırı:
{
"id": "s:8812:FT:TOT:2.5:",
"kind": "sport",
"match": "sport",
"title": "Arsenal — Chelsea",
"category": "sports",
"sport": "soccer",
"league": "Premier League",
"teams": ["Arsenal", "Chelsea"],
"market_type": "TOT",
"period": "RT",
"line": 2.5,
"score": null,
"starts_at": 1794700800,
"size_usd": 1000,
"profit_usd": null,
"profit_pct": 2.39,
"legs": [
{
"platform": "polymarket",
"side": "yes",
"outcome": "Over 2.5",
"covers": ["O"],
"price_avg": 0.505,
"odds": null,
"stake_unit": 0.505,
"currency": "USD"
},
{
"platform": "fonbet",
"side": "bet",
"outcome": "Under 2.5",
"covers": ["U"],
"odds": 2.12,
"stake_unit": 0.471698,
"currency": "RUB"
}
]
}
Çizginin beş düzeyi satırın alanlarına şöyle karşılık gelir:
| Düzey | Alanlar | Örnekte |
|---|---|---|
| Etkinlik | title, sport, league, teams, starts_at | Arsenal — Chelsea, soccer, Premier League |
| Piyasa | market_type, period, line, score | TOT, FT, 2,5 |
| Bacak | platform, side, outcome, covers | fonbet, bet, 2,5 alt, U |
| Fiyat | odds, price_avg, stake_unit, currency | 2,12, 0,471698, RUB |
| Sonuç | size_usd, profit_pct, profit_usd | 1000, 2,39, null |
market_type piyasadır: WIN maç sonucu, HCP handikap, TOT toplam, BTTS iki takım da gol atar, CS kesin skor; skor score içinde. side, kontrat alımı için yes veya no, oranlı bahis için bet değerini alır. covers, bacağın kapsadığı sonuçları listeler: burada O üst, U alttır.
Bahis tutarı stake_unit'e göre nasıl bölünür
stake_unit, bir bacak kazandığında 1 $ geri getirmesi için ona ne kadar yatırılacağıdır. Oranlı bahiste 1 / odds değeridir: 1 / 2,12 = 0,471698. YES veya NO alımında komisyon dahil ortalama emir defteri fiyatıdır; açıklayıcı örnekte komisyon yok, bu yüzden stake_unit, price_avg'ye eşittir.
Birimlerin toplamı 0,505 + 0,471698 = 0,976698 eder, dolayısıyla kâr 1 / 0.976698 − 1 = 2.39%. Kendi S tutarınızı surebet formülüyle bölün: bacak tutarı = S × stake_unit / Σ stake_unit. 500 $ için:
| Bacak | Tutar | Kazanırsa |
|---|---|---|
| Polymarket · YES «Over 2.5», 50,5¢ | 258,52 $ | 511,92 hisse — 511,92 $ |
| Fonbet · 2,5 alt @2,12 | 241,48 $ | 511,94 $ |
Her iki sonuç da yaklaşık 511,93 $ getirir; en kötü durumdaki kâr 11,92 $. size_usd, tahmin platformlarının emir defterlerinin bu fiyatlarda ne kadarını karşılayabildiğidir. Burada 1.000 $'dır: 1.000 / 0,505 ≈ 1.980,2 hisse, dolayısıyla bahis şirketi kabul ederse Fonbet bahsi 1.980,2 × 0,471698 ≈ 934,06 $'a kadar çıkabilir.
profit_usd null'dır, çünkü dolar kârı Fonbet'in ne kadar kabul ettiğine bağlıdır ve bahis şirketi bahis limitini yayımlamaz. Bu nedenle min_profit_usd filtresi bahis şirketi bacağı olan tüm surebet'leri eler; onları min_profit_pct ile filtreleyin.
Fonbet bahsi rubledir (currency = RUB). Açıklayıcı 1 $ = 80 ₽ kuruyla bu 241,48 × 80 = 19.318,40 ₽ eder; 2,5 alt 19.318,40 × 2,12 = 40.955,01 ₽ getirir. Dönüştürmedeki kur farkı profit_pct'ye dahil değildir.
Python: min_profit_pct ile futbol surebet'leri
Betik, kârı %1,5 ve üzeri olan futbol surebet'lerini ister, her birini maça kalan süreyle yazdırır ve BANK tutarını stake_unit'e göre bacaklara böler. Anahtar GENESIS_API_KEY ortam değişkeninden gelir; nasıl alınacağı hızlı başlangıç bölümünde.
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "sport", "sport": "soccer", "min_profit_pct": 1.5}
BANK = 500 # tüm surebet için toplam bahis tutarı, $
def fetch():
while True:
r = requests.get(f"{API}/predictions/arbitrage",
headers=HEADERS, params=PARAMS, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
if r.status_code == 403:
raise SystemExit("mode=sport için Pro veya Max planı gerekir")
r.raise_for_status()
return r.json()["data"]
def unit(leg): # 1 $'lık kazanç: stake_unit, yoksa 1/odds veya fiyat
if leg.get("stake_unit"):
return leg["stake_unit"]
return 1 / leg["odds"] if leg.get("odds") else leg["price_avg"]
for row in fetch():
mkt = [row["market_type"], row["line"], row["period"]]
mkt = " ".join(str(v) for v in mkt if v is not None)
hours = (row["starts_at"] - time.time()) / 3600
print(f"{row['profit_pct']}% · {row['title']} · {mkt} · "
f"başlangıca {hours:.1f} sa")
total = sum(unit(leg) for leg in row["legs"])
for leg in row["legs"]:
price = leg.get("odds") or leg.get("price_avg")
print(f" {leg['platform']}: {leg['outcome']} at {price} — "
f"${BANK * unit(leg) / total:.2f} ({leg['currency']})")
Her bacağın tutarı, platformun para biriminin yanında dolar olarak yazdırılır: ruble bahsini kendi kurunuzla çevirin. Bir bacakta stake_unit yoksa unit, komisyonsuz 1 / odds veya price_avg değerine döner; bu yüzden kâr gerçekte olduğundan biraz yüksek çıkar.
Yeni surebet'leri izlemek için isteği her meta.freshness_sec süresinde tekrarlayın ve id değerlerini karşılaştırın: her surebet kendi id'sini korur. Filtrelenmiş yanıt ETag olmadan gelir, bu yüzden kotadan aralıkla tasarruf edersiniz: Pro'da her 10 sn, günde 86.400 / 10 = 8.640 çağrı ve 30 günde 8.640 × 30 = 259.200 çağrı eder; kota 5M'dir, bkz. Genesis API limitleri. league, platform (örneğin fonbet) ve max_days filtreleri tahmin piyasaları endpoint'leri rehberinde anlatılıyor.
API'nin kontrol edemediği riskler
API, surebet'i bir snapshot'tan fiyatlar; bahisleri ise iki veya üç platformda kendiniz yaparsınız ve her biri hesabı bozabilir.
- Oranlar hareket eder. Snapshot ile bahsiniz arasında saniyeler veya dakikalar geçer: bahis şirketi oranı düşürür veya defterdeki ucuz emirler dolar.
- Limitler ve bahis limitleme. Bahis şirketi istediğinizden azını kabul edebilir veya hesabı kısıtlayabilir; nedenleri Bahis şirketleri arbitraj bahisçilerini neden sınırlar yazısında. Önce oranlı bahsi yapın, sonra kabul edilen tutar kadar YES veya NO alın.
- Void. Maç iptal edilir veya ertelenirse bahis şirketi genellikle oranlı bahsi 1 oranıyla iade eder, YES/NO piyasası ise kendi kurallarıyla sonuçlanır ve surebet zararla bitebilir.
- Para birimi. Ruble ve dolar dönüşümü satırın kârına dahil değildir.
- Açık hata. Diğer bahis şirketlerinin çok üzerindeki oranlar bir hata olabilir ve bahis şirketi bahsi yeniden sonuçlandırabilir.
Bahis düzenlemesi ülkeden ülkeye farklıdır: yerel yasaları ve her platformun kurallarını kontrol edin. Çalışma düzeni ve tüm riskler Surebet riskleri ve çalışma kuralları dersinde toplanmıştır; aramanın nasıl çalıştığı Surebet tarayıcısı yazısında anlatılıyor.
Sütunlar, filtreler ve etiketler Sport modu rehberinde anlatılıyor.
Sorular ve cevaplar
Ücretsiz bir spor oranları API'si var mı?
Sağlayıcıya bağlıdır: istek hakkı, bahis şirketi ve piyasa listesi değişir; ücretsiz erişim varsa hacim bakımından sınırlıdır. Polymarket ve Kalshi piyasa verilerini resmi API'leriyle anahtarsız sunar (Polymarket, Kalshi), ancak bunlar bahis şirketi oranı değil, YES ve NO kontrat fiyatlarıdır. Genesis API'nin ücretsiz planı yoktur: mode=sport, Pro (ayda 100 $) ve Max (200 $) planlarındadır; planları Genesis API fiyatlandırması sayfasında karşılaştırın.
API'de canlı oranlar var mı?
Genesis API'de yok: sport modu yalnızca maç öncesi surebet arar ve maç başlayınca surebet yanıttan çıkar. Canlı arbitrajların neden daha sık bozulduğu Maç öncesi ve canlı arbitraj yazısında.
Bir surebet'te profit_usd neden null?
En az bir bacak bahis şirketi bahsidir ve bahis şirketi hesabınız için bahis limitini yayımlamaz. profit_pct yüzdesi bellidir; her bacağın tutarını stake_unit'ten hesaplayın.
Genesis API üzerinden bahis yapabilir miyim?
Hayır. Genesis API yalnızca veri okur: bahisleri ve alımları legs[].url içindeki bağlantıları kullanarak platformlarda kendiniz yaparsınız.