Genesis Arbitrage

Genesis Arbitrage · · 15 menit baca

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=sport di paket Pro dan Max, Genesis API mengembalikan surebet pre-match dari 13 platform beserta stake_unit untuk 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.

TingkatIsinyaContoh
EventOlahraga, kompetisi, tim, waktu mulaiSepak bola, Bundesliga, Bayern — Dortmund
PasarJenis taruhan, periode, garisTotal 2,5, waktu normal
OutcomePilihan yang dipasangi taruhanOver 2,5
HargaOdds tiap bookmakerFonbet @1,95, Winline @2,02
WaktuKapan harga diperbarui12 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.

HargaOdds desimalProbabilitas
@2,25 di bookmaker2,2544,44%
@3,60 di bookmaker3,6027,78%
YES di 30¢ di Polymarket1 / 0,30 = 3,3330%

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.

OutcomeOdds terbaikDi mana1/k
1, Bayern menang@2,25Betcity0,44444
X, seri@3,60Marathon0,27778
2, Dortmund menang@3,80Winline0,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.

TaruhanStakeJika 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 diperiksaDi mana bisa salahField di mode=sport
Pertandingan dan skuadBayern vs Bayern II, tim putri atau juniorteams, flags
Waktu mulaiSatu bookmaker menjadwal ulang pertandinganstarts_at
Jenis pasarHasil, handicap, total, BTTS, skor pastimarket_type
PeriodeWaktu normal atau pertandingan dengan perpanjangan waktuperiod
GarisHandicap −1,5 dan −1,25 adalah taruhan berbedaline
Outcome tiap legBersama-sama leg harus mencakup semua outcomelegs[].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:

TingkatFieldPada contoh
Eventtitle, sport, league, teams, starts_atArsenal — Chelsea, soccer, Premier League
Pasarmarket_type, period, line, scoreTOT, FT, 2,5
Legplatform, side, outcome, coversfonbet, bet, Under 2,5, U
Hargaodds, price_avg, stake_unit, currency2,12, 0,471698, RUB
Hasilsize_usd, profit_pct, profit_usd1000, 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:

LegStakeJika menang
Polymarket · YES «Over 2.5» di 50,5¢$258,52511,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.

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.