API odds olahraga untuk arbitrase taruhan: event, odds, dan surebet lewat API
Ringkasan
- API odds olahraga mengembalikan event, pasar, dan odds setiap bookmaker beserta waktu pembaruan terakhir. Probabilitas implisit dari odds desimal adalah 1/k, dan harga kontrak YES di pasar prediksi adalah probabilitas yang sama dalam dolar.
- Surebet ada jika jumlah 1/k dari odds terbaik untuk semua outcome sebuah pasar kurang dari 1, dan setiap stake proporsional dengan 1/k. Kesalahan paling sering terjadi saat pencocokan: pertandingan, pasar, periode, dan garis harus sama di setiap platform.
- Dengan
mode=sportdi paket Pro dan Max, Genesis API mengembalikan surebet pre-match dari 13 platform besertastake_unituntuk setiap leg.profit_usd-nya null karena batas stake bookmaker tidak diketahui.
API odds olahraga, disebut juga API taruhan olahraga, memberi program akses ke garis taruhan: event, pasar, dan odds setiap bookmaker, lengkap dengan waktu pembaruan terakhir tiap harga. Dari data ini program membandingkan harga antarplatform dan menemukan surebet, yaitu taruhan pada setiap outcome sebuah pertandingan yang berakhir untung apa pun hasilnya, selama semua taruhan diterima dan diselesaikan dengan aturan yang sama. Inilah arbitrase taruhan, dan Genesis API menyajikan surebet siap pakai dari 13 platform lewat endpoint /predictions/arbitrage dengan mode=sport.
Apa yang dikembalikan API odds olahraga
Penyedia menamai field secara berbeda, tetapi API odds menggambarkan garis taruhan dalam lima tingkat. Tanpa periode dan garis, dua odds tidak bisa dibandingkan, dan tanpa waktu Anda tidak tahu apakah harga masih berlaku. Kolom kanan adalah contoh ilustrasi.
| Tingkat | Isinya | Contoh |
|---|---|---|
| Event | Olahraga, kompetisi, tim, waktu mulai | Sepak bola, Bundesliga, Bayern — Dortmund |
| Pasar | Jenis taruhan, periode, garis | Total 2,5, waktu normal |
| Outcome | Pilihan yang dipasangi taruhan | Over 2,5 |
| Harga | Odds tiap bookmaker | Fonbet @1,95, Winline @2,02 |
| Waktu | Kapan harga diperbarui | 12 detik lalu |
Odds datang dalam format desimal, pecahan, atau Amerika, sedangkan platform prediksi mencantumkan harga kontrak dalam dolar, bukan odds. Datanya berasal dari API terbuka milik platform sendiri atau dari penyedia yang mengumpulkan garis banyak bookmaker ke satu format. Data Polymarket dan Kalshi dibahas di artikel API Polymarket dan Kalshi.
Odds, probabilitas, dan harga dalam sen
Odds desimal menunjukkan berapa yang kembali untuk setiap dolar yang dipertaruhkan, termasuk stake: $100 pada @2,25 menjadi $225. Kebalikannya adalah probabilitas implisit: 1 / 2,25 = 0,4444, atau 44,44%. Odds pecahan dan Amerika dikonversi ke desimal dengan rumus di Penjelasan betting odds.
| Harga | Odds desimal | Probabilitas |
|---|---|---|
| @2,25 di bookmaker | 2,25 | 44,44% |
| @3,60 di bookmaker | 3,60 | 27,78% |
| YES di 30¢ di Polymarket | 1 / 0,30 = 3,33 | 30% |
Kontrak YES membayar $1 jika outcome-nya terjadi, sehingga harga dolarnya adalah estimasi probabilitas pasar. Kontrak NO pada «Bayern menang» menang jika Dortmund menang atau pertandingan seri, seperti double chance.
Di satu bookmaker, probabilitas semua outcome sebuah pasar berjumlah lebih dari 1, dan kelebihannya adalah margin-nya. Contoh ilustrasi: garis Fonbet untuk Bayern — Dortmund, 2,15 / 3,45 / 3,40, menghasilkan 0,46512 + 0,28986 + 0,29412 = 1,04910, margin 4,91%. Perhitungan langkah demi langkah ada di Cara menghitung margin bookmaker.
Cara menemukan surebet dari odds
Surebet ditemukan dari harga terbaik di antara bookmaker: untuk setiap outcome pasar, ambil odds tertinggi lalu jumlahkan 1/k. Contoh ilustrasi: pertandingan yang sama, pasar hasil pertandingan pada waktu normal.
| Outcome | Odds terbaik | Di mana | 1/k |
|---|---|---|---|
| 1, Bayern menang | @2,25 | Betcity | 0,44444 |
| X, seri | @3,60 | Marathon | 0,27778 |
| 2, Dortmund menang | @3,80 | Winline | 0,26316 |
L = 0.44444 + 0.27778 + 0.26316 = 0.98538
Jumlahnya di bawah 1, jadi ada surebet, dengan profit 1 / 0.98538 − 1 = 1.48%. Garis milik keempat bookmaker pada kode di bawah memiliki margin 3,8% sampai 5,1%; surebet muncul dari perbedaan cara mereka memberi harga pada pertandingan.
Total stake dibagi proporsional dengan 1/k: dari $1.000, kemenangan tuan rumah mendapat 1.000 × 0,44444 / 0,98538 = $451,04, dan stake lainnya ada di tabel.
| Taruhan | Stake | Jika menang |
|---|---|---|
| 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 |
Setiap outcome mengembalikan sekitar 1.000 / 0,98538 = $1.014,84; profit terburuk adalah $14,83 akibat pembulatan stake.
Logika yang sama dalam kode, dengan garis satu pasar di empat bookmaker sebagai input:
# Contoh ilustrasi: garis satu pasar 1X2 di empat bookmaker
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()
# odds terbaik untuk tiap outcome dan bookmaker yang menawarkannya
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 # tidak ada surebet
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 %
Pasar dua arah, seperti handicap, total, atau kedua tim mencetak gol, memiliki dua kunci di dictionary, dan rumusnya tetap sama. Pembulatan stake dan penghitungan ulang setelah odds bergerak dibahas di pelajaran Cara menghitung surebet.
Pencocokan: satu pertandingan, pasar, periode, dan garis
Rumus hanya berlaku jika setiap harga berasal dari pasar yang sama di pertandingan yang sama. Bookmaker menulis nama tim secara berbeda, waktu mulai berselisih beberapa menit, dan pasar punya nama sendiri. Kesalahan pencocokan menghasilkan surebet palsu: 1/k berjumlah kurang dari 1, tetapi pada salah satu outcome semua taruhan kalah.
| Yang diperiksa | Di mana bisa salah | Field di mode=sport |
|---|---|---|
| Pertandingan dan skuad | Bayern vs Bayern II, tim putri atau junior | teams, flags |
| Waktu mulai | Satu bookmaker menjadwal ulang pertandingan | starts_at |
| Jenis pasar | Hasil, handicap, total, BTTS, skor pasti | market_type |
| Periode | Waktu normal atau pertandingan dengan perpanjangan waktu | period |
| Garis | Handicap −1,5 dan −1,25 adalah taruhan berbeda | line |
| Outcome tiap leg | Bersama-sama leg harus mencakup semua outcome | legs[].covers |
Waktu normal dalam sepak bola adalah 90 menit plus tambahan waktu. Platform taruhan biasanya menyelesaikan hasil pertandingan, handicap, dan total di sepak bola dan hoki berdasarkan waktu normal, kecuali nama pasarnya menyebut perpanjangan waktu dan adu penalti termasuk. Pasar pemenang di platform prediksi bisa mencakup perpanjangan waktu, dan saat itu seri di waktu normal dapat membuat seluruh pasangan kalah.
Handicap berpasangan menjadi surebet dengan handicap lawan yang sama besar: tuan rumah −1,5 dan tamu +1,5. Pada Asian handicap seperempat seperti −0,75, stake dibagi dua ke dua garis yang berdekatan, dan tuan rumah −0,75 dengan tamu +0,75 juga mencakup semua skor. Total berpasangan pada satu garis: over 2,5 dengan under 2,5.
Pasangan sebaliknya, over 2,5 dan under 3,5, adalah middle: dengan tiga gol kedua taruhan menang. Di Genesis API, line dan period ditetapkan sekali untuk seluruh surebet, sehingga leg dengan garis berbeda tidak pernah masuk ke satu baris.
Surebet lewat Genesis API: mode=sport
Endpoint /predictions/arbitrage dengan mode=sport mengembalikan surebet yang pekerjaan di atasnya sudah dilakukan: event dicocokkan antarplatform, harga terbaik dipilih, dan leg platform prediksi dilalui di order book beserta fee. Ada 13 platform: Polymarket, Kalshi, Predict.fun, dan 10 platform taruhan — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB, dan Dafa Sports. Hanya pre-match: begitu pertandingan dimulai, surebet-nya hilang dari respons.
Mode ini bagian dari paket Pro ($100 per bulan, snapshot baru setiap 10 dtk) dan Max ($200, setiap 5 dtk); di Trial dan Start, request mengembalikan 403 plan_restricted. API tidak mengembalikan garis lengkap tiap bookmaker: respons hanya berisi surebet yang ditemukan, dengan platform, outcome, dan harga setiap leg.
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
Contoh ilustrasi: satu baris mode=sport dari dokumentasi dengan harga yang dihitung ulang:
{
"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"
}
]
}
Lima tingkat garis taruhan dipetakan ke field baris sebagai berikut:
| Tingkat | Field | Pada contoh |
|---|---|---|
| Event | title, sport, league, teams, starts_at | Arsenal — Chelsea, soccer, Premier League |
| Pasar | market_type, period, line, score | TOT, FT, 2,5 |
| Leg | platform, side, outcome, covers | fonbet, bet, Under 2,5, U |
| Harga | odds, price_avg, stake_unit, currency | 2,12, 0,471698, RUB |
| Hasil | size_usd, profit_pct, profit_usd | 1000, 2,39, null |
market_type adalah pasarnya: WIN — hasil pertandingan, HCP — handicap, TOT — total, BTTS — kedua tim mencetak gol, CS — skor pasti, dengan skor di score. side bernilai yes atau no untuk pembelian kontrak dan bet untuk taruhan dengan odds. covers mendaftar outcome yang dicakup sebuah leg: di sini O adalah over dan U adalah under.
Cara membagi stake dengan stake_unit
stake_unit adalah jumlah yang ditaruh pada sebuah leg agar mengembalikan $1 jika leg itu menang. Untuk taruhan dengan odds nilainya 1 / odds: 1 / 2,12 = 0,471698. Untuk pembelian YES atau NO nilainya adalah harga rata-rata order book termasuk fee; contoh ilustrasi ini tidak memakai fee, jadi stake_unit sama dengan price_avg.
Jumlah unitnya 0,505 + 0,471698 = 0,976698, sehingga profitnya 1 / 0.976698 − 1 = 2.39%. Bagi jumlah Anda sendiri S dengan rumus surebet: stake leg = S × stake_unit / Σ stake_unit. Untuk $500:
| Leg | Stake | Jika menang |
|---|---|---|
| Polymarket · YES «Over 2.5» di 50,5¢ | $258,52 | 511,92 share — $511,92 |
| Fonbet · Under 2,5 @2,12 | $241,48 | $511,94 |
Kedua outcome mengembalikan sekitar $511,93, profit terburuk $11,92. size_usd adalah jumlah yang mampu diserap order book platform prediksi pada harga ini. Di sini nilainya $1.000: 1.000 / 0,505 ≈ 1.980,2 share, jadi taruhan Fonbet bisa naik hingga 1.980,2 × 0,471698 ≈ $934,06 jika bookmaker menerimanya.
profit_usd bernilai null karena profit dalam dolar bergantung pada jumlah yang diterima Fonbet, dan bookmaker tidak mempublikasikan batas stake-nya. Karena itu filter min_profit_usd membuang setiap surebet yang punya leg bookmaker; filter dengan min_profit_pct saja.
Taruhan Fonbet dalam rubel (currency = RUB). Pada kurs ilustrasi 80 ₽ per $1, itu 241,48 × 80 = 19.318,40 ₽, dan under 2,5 mengembalikan 19.318,40 × 2,12 = 40.955,01 ₽. Selisih kurs saat konversi tidak termasuk dalam profit_pct.
Python: surebet sepak bola dengan min_profit_pct
Skrip meminta surebet sepak bola dengan profit 1,5% atau lebih, mencetak masing-masing beserta waktu hingga kick-off, dan membagi jumlah BANK ke setiap leg menurut stake_unit. Kunci diambil dari variabel lingkungan GENESIS_API_KEY; cara mendapatkannya ada di mulai cepat.
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 # total stake untuk satu surebet, $
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 memerlukan paket Pro atau Max")
r.raise_for_status()
return r.json()["data"]
def unit(leg): # kemenangan $1: stake_unit, atau 1/odds atau harga
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"mulai dalam {hours:.1f} jam")
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']})")
Jumlah tiap leg dicetak dalam dolar di samping mata uang platform: konversikan taruhan rubel dengan kurs Anda sendiri. Jika sebuah leg tidak punya stake_unit, unit memakai 1 / odds atau price_avg tanpa fee, sehingga profit yang tampak sedikit lebih tinggi dari yang sebenarnya.
Untuk melacak surebet baru, ulangi request setiap meta.freshness_sec dan bandingkan nilai id: setiap surebet mempertahankan id-nya. Respons yang difilter datang tanpa ETag, jadi Anda menghemat kuota lewat interval: setiap 10 dtk di Pro berarti 86.400 / 10 = 8.640 panggilan per hari dan 8.640 × 30 = 259.200 per 30 hari terhadap kuota 5M, lihat Limit Genesis API. Filter league, platform (misalnya fonbet), dan max_days dijelaskan di panduan endpoint pasar prediksi.
Risiko yang tidak bisa diperiksa API
API menghitung harga surebet dari snapshot, sedangkan Anda memasang taruhan sendiri di dua atau tiga platform, dan masing-masing bisa merusak perhitungan.
- Odds bergerak. Selisih detik atau menit antara snapshot dan taruhan Anda: bookmaker menurunkan odds, atau order murah di order book sudah terisi.
- Limit dan stake limiting. Bookmaker bisa menerima lebih sedikit dari yang Anda minta atau membatasi akun; alasannya ada di Mengapa bookmaker membatasi arber. Pasang taruhan dengan odds dulu, lalu beli YES atau NO sesuai jumlah yang diterima.
- Void. Jika pertandingan dibatalkan atau ditunda, bookmaker biasanya mengembalikan taruhan pada odds 1, sedangkan pasar YES/NO diselesaikan dengan aturannya sendiri, dan surebet bisa berakhir rugi.
- Mata uang. Konversi rubel dan dolar tidak termasuk dalam profit baris.
- Kesalahan odds. Odds yang jauh di atas bookmaker lain bisa jadi kesalahan, dan bookmaker dapat menyelesaikan ulang taruhan.
Regulasi taruhan berbeda di tiap negara: periksa hukum setempat dan aturan setiap platform. Urutan kerja dan semua risiko dirangkum di pelajaran Risiko surebet dan aturan kerja, dan cara kerja pencarian dijelaskan di Scanner surebet.
Kolom, filter, dan tag dijelaskan di panduan mode Sport.
Tanya jawab
Apakah ada API odds olahraga gratis?
Tergantung penyedia: jatah request serta daftar bookmaker dan pasar berbeda-beda, dan akses gratis, jika ada, terbatas volumenya. Polymarket dan Kalshi menyediakan data pasar lewat API resmi tanpa kunci (Polymarket, Kalshi), tetapi itu adalah harga kontrak YES dan NO tanpa odds bookmaker. Genesis API tidak punya paket gratis: mode=sport ada di Pro ($100 per bulan) dan Max ($200); bandingkan paket di harga Genesis API.
Apakah API punya odds live?
Tidak di Genesis API: mode sport hanya mencari surebet pre-match, dan surebet hilang dari respons begitu pertandingan dimulai. Mengapa arb live lebih sering gagal dibahas di Arbitrase pre-match vs in-play.
Mengapa profit_usd null pada surebet?
Setidaknya satu leg adalah taruhan bookmaker, dan bookmaker tidak mempublikasikan batas stake untuk akun Anda. Persentase profit_pct diketahui; hitung jumlah tiap leg dari stake_unit.
Bisakah saya memasang taruhan lewat Genesis API?
Tidak. Genesis API hanya membaca data: Anda memasang taruhan dan pembelian sendiri di platform, memakai tautan di legs[].url.