Genesis Arbitrage

Genesis Arbitrage · · 12 menit baca

Pasar prediksi dan surebet di Genesis API: endpoint, filter, dan field

Ringkasan

  • Enam endpoint: arbitrase prediksi dan status platform mulai paket Start; analitik, smart money, transaksi besar, dan peringkat trader di Pro dan Max.
  • Bundle arbitrase dihitung lewat order book dengan fee: ukuran transaksi, profit dalam $ dan %, APR, hari hingga settlement, dan kode risiko.
  • Mode sport mengembalikan surebet di 13 platform, hanya pre-match. Jika satu leg adalah bet dengan odds, profit_usd bernilai null karena batas stake bet itu tidak diketahui.

Genesis API menyajikan data pasar prediksi lewat enam endpoint GET: bundle arbitrase antara Polymarket, Kalshi, Limitless, Predict.fun, dan Opinion, surebet di 13 platform, status platform, analitik, smart money, transaksi besar, dan peringkat trader. Ini data di balik halaman Arbitrase prediksi, Analitik, dan Smart Money, dalam format JSON. Anda bisa membangun bot, dashboard, atau notifikasi di atasnya; transaksi dan bet Anda lakukan sendiri di platform.

Endpoint dan paket

EndpointHasilPaket API
/predictions/arbitrageBundle arbitrase dan surebetStart, Pro, Max; mode llm dan sport — Pro, Max
/predictions/platformsStatus platformStart, Pro, Max
/predictions/analyticsKPI, pergerakan harga, aliran danaPro, Max
/predictions/smart-moneyTransaksi besar, whale, pola insiderPro, Max
/predictions/tradesAliran transaksi PolymarketPro, Max
/predictions/traders300 trader Polymarket teratas berdasarkan PnLPro, Max

Di Trial keenamnya mengembalikan 403 plan_restricted; di Start, request dengan mode=llm dan mode=sport juga sama. Format respons dibahas di panduan respons dan error, kuota di panduan limit.

Arbitrase prediksi: mode

Parameter mode menentukan bundle mana yang dikembalikan /predictions/arbitrage.

modeHasilkindPaket
exactEvent yang sama di dua platform, defaultcrossStart, Pro, Max
dutchKumpulan outcome dari satu event di satu platformdutchStart, Pro, Max
llmPasangan event yang diverifikasi AIcrossPro, Max
sportSurebet pada pertandingansportPro, Max

Profit sudah dihitung lewat order book platform beserta fee. Request bundle exact dengan profit minimal 1% yang settle dalam 30 hari:

curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d mode=exact -d min_profit_pct=1 -d max_days=30

Filter

ParameterTipeFungsi
modestringexact (default), dutch, llm, atau sport
categorystringKategori, seperti pada field category
platformstringMinimal satu leg di platform ini; beberapa dipisah koma
min_profit_pctnumberProfit minimum, %
min_profit_usdnumberProfit minimum, $; baris dengan profit_usd = null dilewati
min_aprnumberAPR minimum, %
max_daysnumberMaksimal sekian hari hingga settlement
sport, leaguestringCabang olahraga dan liga, untuk mode=sport

Filter bersifat opsional dan bisa digabung. Tulis platform seperti di legs[].platform: polymarket, kalshi, fonbet. mode yang tidak dikenal mengembalikan 400 bad_request.

Bundle dan leg-nya

Contoh ilustrasi: satu baris mode=exact dari dokumentasi, dipersingkat.

{
  "id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…",
  "kind": "cross",
  "match": "exact",
  "title": "Will Jean Castex win the 2027 French presidential…",
  "category": "Elections",
  "ends_at": 1843308000,
  "days_left": 562.87,
  "size_usd": 107175.08,
  "fees_usd": 28.08,
  "profit_usd": 153.69,
  "profit_pct": 0.14,
  "apr_pct": 0.1,
  "shares": 107356.85,
  "risks": ["rules_differ", "end_mismatch"],
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "outcome": "Jean Castex",
      "price_avg": 0.0013,
      "cost_usd": 140.3,
      "fee_usd": 5.6,
      "url": "https://polymarket.com/event/next-french-presidential-…"
    },
    {
      "platform": "kalshi",
      "side": "no",
      "outcome": "No",
      "price_avg": 0.997,
      "cost_usd": 107034.78,
      "fee_usd": 22.48,
      "url": "https://kalshi.com/events/KXFRENCHPRES-27"
    }
  ]
}
FieldArti
id, first_seen, updated_atID tetap, kapan bundle muncul dan diperbarui
kind, matchcross, dutch, atau sport; match adalah exact, llm, atau sport
title, categoryEvent atau pasar beserta kategorinya
ends_at, days_left, starts_atWaktu settlement, hari hingga settlement, awal pertandingan
size_usd, fees_usd, sharesUkuran transaksi dan fee dalam $, jumlah share
profit_usd, profit_pct, apr_pctProfit dalam $ dan %, APR; apr_pct bernilai null jika kurang dari sehari
edge_cents, risksSelisih harga dalam sen per share, kode risiko
legs[].platform, market, outcomePlatform, pasar, dan outcome leg
legs[].sideyes atau no — apa yang dibeli; bet — bet dengan odds
legs[].price_best, price_avg, price_worstHarga terbaik, rata-rata, dan terburuk saat menelusuri book
legs[].shares, cost_usd, fee_usd, urlShare, biaya, fee, dan tautan pasar dari leg

Harga leg adalah pecahan dolar: satu share membayar $1 jika outcome-nya menang, jadi 0.997 berarti 99,7¢. Jika kedua platform settle dengan cara yang sama, satu leg pasti menang apa pun yang terjadi, dan shares adalah jumlah yang Anda terima. rules_differ berarti aturan settlement platform bisa berbeda; end_mismatch berarti tanggal settlement-nya berbeda.

Pada contoh, 107.356,85 − 107.175,08 − 28,08 = profit $153,69, atau 153,69 / 107.203,16 = 0,14%. Dana terkunci 562,87 hari hingga settlement, sehingga tingkat tahunannya 0,14 × 365 / 562,87 ≈ 0,1%. Filter max_days menyaring bundle seperti ini.

Mode sport: surebet

Satu baris sport adalah satu pasar dari satu pertandingan: 2 atau 3 leg di platform berbeda yang bersama-sama mencakup semua outcome-nya. 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 hilang dari daftar.

Contoh ilustrasi: satu baris mode=sport dari dokumentasi dengan harga yang dihitung ulang.

{
  "id": "s:8812:RT:TOT:2.5:",
  "kind": "sport",
  "title": "Arsenal — Chelsea",
  "sport": "soccer",
  "league": "Premier League",
  "teams": ["Arsenal", "Chelsea"],
  "market_type": "TOT",
  "period": "RT",
  "line": 2.5,
  "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"
    }
  ]
}
FieldArti
sport, league, teams, flagsCabang olahraga, liga, tim, tag pertandingan
market_typeWIN — hasil, HCP — handicap, TOT — total, BTTS — kedua tim mencetak gol, CS — skor akurat
period, line, scorePeriode settlement, garis handicap atau total, skor untuk CS
legs[].coversOutcome yang dicakup leg: O — over, U — under
legs[].oddsOdds desimal; null untuk pembelian YES atau NO
legs[].stake_unitPorsi stake: berapa yang ditaruh pada leg untuk mendapat $1 jika menang, fee sudah termasuk
legs[].currencyMata uang platform

Untuk bet dengan odds, stake_unit = 1 / odds: 1 / 2,12 = 0,471698. Jumlah stake unit semua leg adalah 0,505 + 0,471698 = 0,976698, di bawah 1, sehingga profitnya 1 / 0,976698 − 1 = 2,39%. Untuk membagi dana Anda sendiri, gunakan stake leg = jumlah × stake_unit / Σ stake_unit.

size_usd adalah jumlah pembelian di platform prediksi yang bisa diserap order book-nya. $1.000 pada 0,505 membeli 1.000 / 0,505 ≈ 1.980,2 share YES "Over 2.5". Agar "Under 2.5" mengembalikan jumlah yang sama, stake Fonbet adalah 1.980,2 × 0,471698 ≈ $934,06.

Fonbet menerima bet dalam rubel (currency = RUB): konversikan jumlahnya dengan kurs Anda sendiri, karena nilai tukar tidak termasuk dalam profit_pct. profit_usd di sini null karena platform taruhan tidak mempublikasikan batas stake-nya.

Status platform

/predictions/platforms menunjukkan seberapa segar data arbitrase. Endpoint ini tanpa parameter; data berisi dua daftar:

{
  "platforms": [
    {
      "platform": "kalshi",
      "mode": "rest",
      "quotes_at": 1794675858,
      "full_scan_at": 1794675012,
      "markets": 26187,
      "hot_markets": 188
    }
  ],
  "bookmakers": [
    {
      "bookmaker": "fonbet",
      "title": "Fonbet",
      "ok": true,
      "events": 1840,
      "matched_events": 212,
      "updated_at": 1794675855,
      "currency": "RUB"
    }
  ]
}

Sebaiknya lewati bundle dengan platform berstatus down atau ok = false: harganya mungkin sudah bergeser.

Analitik, smart money, transaksi, dan trader

Empat endpoint di Pro dan Max mencerminkan layar pada panduan Analitik dan Smart Money.

EndpointParameterIsinya
/predictions/analyticstidak adaKPI, pergerakan harga 1 jam dan 24 jam, aliran dana, pasar yang segera settle, pasar baru
/predictions/smart-moneytidak adaKPI, aliran dana, insiders, concentration, smart_vs_price
/predictions/tradesperiod, wallet, category, side, min_usd, insiderTransaksi Polymarket, terbaru lebih dulu
/predictions/tradersperiod: 30d (default), 7d, all300 trader Polymarket teratas berdasarkan PnL

Label insider menggambarkan pola perilaku sebuah wallet dan tidak membuktikan apa pun: alamat baru milik trader berpengalaman bisa bertransaksi dengan cara yang sama.

Parameter aliran transaksi; period menentukan ambang batas:

ParameterTipeFungsi
periodstringlive (default) — transaksi mulai $1.000, mulai $100 untuk smart wallet; today dan 7d — taker mulai $5.000
walletstringTransaksi satu wallet
categorystringKategori pasar
sidestringbuy atau sell
min_usdnumberJumlah transaksi minimum, $
insiderbooleantrue — hanya transaksi berlabel insider
curl -G "https://api.genesisarbitrage.com/v1/predictions/trades" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d period=today -d side=buy -d min_usd=10000
{
  "ts": 1794675812,
  "wallet": "0x3a1c…f09e",
  "tags": ["whale", "smart"],
  "title": "Will Bitcoin reach $150k in 2026?",
  "outcome": "No",
  "side": "buy",
  "price": 0.82,
  "shares": 30487.8,
  "usd": 25000,
  "role": "taker",
  "insider": false,
  "bid_now": 0.81,
  "ask_now": 0.83
}

usd = price × shares: 0,82 × 30.487,8 ≈ 25.000. bid_now dan ask_now adalah harga outcome saat ini: mengikuti transaksi ini sekarang berharga 0,83, 1¢ lebih mahal daripada yang dibayar trader.

/predictions/traders memberikan PnL sepanjang waktu, 30 hari, dan 7 hari (pnl_usd), roi_pct, won dari resolved, dan sparkline pnl_series. Masukkan alamat dari peringkat ke wallet pada aliran transaksi.

Cara menggunakannya

  1. Periksa paket dan platform Anda

    /account/usage menunjukkan paket Anda, /predictions/platforms — seberapa segar quote-nya.

  2. Minta bundle dengan filter

    min_profit_pct dan max_days memangkas noise dan bundle berjangka panjang.

  3. Periksa risiko dan aturan

    Jika ada rules_differ, baca aturan settlement kedua platform.

  4. Polling tidak lebih cepat dari kesegaran paket Anda

    Gunakan interval minimal meta.freshness_sec dan kirim balik ETag di If-None-Match: respons 304 tidak memakai kuota.

  5. Bertransaksi sendiri

    Buka pasar dari legs[].url dan periksa harga di order book-nya.

Request exact yang sama di Python:

import os
from datetime import datetime, timezone

import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
params = {"mode": "exact", "min_profit_pct": 1, "max_days": 30}

r = requests.get(f"{API}/predictions/arbitrage", headers=HEADERS,
                 params=params, timeout=10)
if r.status_code == 403:
    raise SystemExit("Endpoint atau mode tidak termasuk paket API Anda")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"Bundle: {body['meta']['count']}, data per {ts:%H:%M:%S} UTC")

for b in body["data"]:
    print(f"{b['profit_pct']:.2f}% · ${b['profit_usd']:.2f} · "
          f"{b['days_left']:.0f} hari · {b['title'][:40]}")
    for leg in b["legs"]:
        print(f"   {leg['platform']}: {leg['side']} "
              f"{leg['outcome']} at {leg['price_avg']}")
    if b["risks"]:
        print("   risiko:", ", ".join(b["risks"]))

Di situs, bundle yang sama dibahas di panduan Arbitrase prediksi dan Mode Sport; API resmi platform — di artikel tentang API Polymarket dan Kalshi dan odds taruhan lewat API.

Tanya jawab

Bisakah saya membeli kontrak atau memasang bet lewat Genesis API?

Tidak. Genesis API hanya membaca data dan tidak menempatkan order: Anda bertransaksi dan memasang bet sendiri di platform.

Mengapa profit_usd null pada surebet?

Minimal satu leg adalah bet dengan odds, dan platform tidak mempublikasikan batas stake-nya. Persentase profit diketahui; hitung jumlah tiap leg dari stake_unit.

Apakah API menyertakan surebet live?

Tidak, hanya pre-match. Mengapa live lebih berisiko dibahas di artikel pre-match vs live.

Paket apa yang dibutuhkan untuk surebet?

Pro atau Max: di Start, mode=sport mengembalikan 403 plan_restricted. Harga ada di halaman Harga Genesis API.