Genesis Arbitrage

Genesis Arbitrage · · 12 dk okuma

Genesis API'de tahmin piyasaları ve surebet: endpoint'ler, filtreler ve alanlar

Kısaca

  • Altı endpoint: tahmin arbitrajı ve platform durumu Start planından itibaren; analitik, akıllı para, büyük işlemler ve trader sıralaması Pro ve Max'te.
  • Arbitraj paketleri emir defterleri ve komisyonlar hesaba katılarak fiyatlanır: işlem büyüklüğü, $ ve % cinsinden kâr, APR, uzlaşmaya kalan gün ve risk kodları.
  • Sport modu 13 platformda yalnızca maç öncesi surebet döndürür. Bacaklardan biri oranlı bahisse profit_usd null olur, çünkü bu bahsin limiti bilinmez.

Genesis API, tahmin piyasası verilerini altı GET endpoint'iyle sunar: Polymarket, Kalshi, Limitless, Predict.fun ve Opinion arasındaki arbitraj paketleri, 13 platformdaki surebet'ler, platform durumu, analitik, akıllı para, büyük işlemler ve trader sıralaması. Tahmin arbitrajı, Analitik ve Akıllı Para sayfalarının arkasındaki veriler JSON olarak gelir. Üzerine bot, panel veya bildirim kurabilirsiniz; işlemleri ve bahisleri platformlarda siz yaparsınız.

Endpoint'ler ve planlar

EndpointNe döndürürAPI planları
/predictions/arbitrageArbitraj paketleri ve surebet'lerStart, Pro, Max; llm ve sport modları — Pro, Max
/predictions/platformsPlatform durumuStart, Pro, Max
/predictions/analyticsKPI'lar, fiyat hareketleri, para akışlarıPro, Max
/predictions/smart-moneyBüyük işlemler, balinalar, insider kalıplarıPro, Max
/predictions/tradesPolymarket işlem akışıPro, Max
/predictions/tradersPnL'e göre ilk 300 Polymarket trader'ıPro, Max

Trial'da altısı da 403 plan_restricted döndürür; Start'ta mode=llm ve mode=sport istekleri de aynı yanıtı alır. Yanıt formatı yanıtlar ve hatalar rehberinde, kota limitler rehberinde anlatılır.

Tahmin arbitrajı: modlar

mode parametresi, /predictions/arbitrage endpoint'inin hangi paketleri döndüreceğini belirler.

modeNe alırsınızkindPlanlar
exactİki platformdaki aynı olay, varsayılancrossStart, Pro, Max
dutchTek platformda bir olayın sonuç kümesidutchStart, Pro, Max
llmYapay zekâ ile doğrulanmış olay çiftlericrossPro, Max
sportMaçlarda surebet'lersportPro, Max

Kâr, platformların emir defterleri ve komisyonlar üzerinden zaten hesaplanmıştır. En az %1 kâr sağlayan ve 30 gün içinde uzlaşan exact paketleri için bir istek:

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

Filtreler

ParametreTürNe yapar
modestringexact (varsayılan), dutch, llm veya sport
categorystringKategori, category alanındaki gibi
platformstringEn az bir bacak bu platformda; birden fazlası virgülle ayrılır
min_profit_pctnumberAsgari kâr, %
min_profit_usdnumberAsgari kâr, $; profit_usd = null olan satırlar atlanır
min_aprnumberAsgari APR, %
max_daysnumberUzlaşmaya en fazla bu kadar gün kalmış
sport, leaguestringmode=sport için spor dalı ve lig

Filtreler isteğe bağlıdır ve birlikte kullanılabilir. Platformu legs[].platform içindeki gibi yazın: polymarket, kalshi, fonbet. Bilinmeyen bir mode, 400 bad_request döndürür.

Paket ve bacakları

Örnek amaçlı: dokümantasyondan kısaltılmış bir mode=exact satırı.

{
  "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"
    }
  ]
}
AlanAnlamı
id, first_seen, updated_atSabit kimlik, paketin ortaya çıktığı ve güncellendiği an
kind, matchcross, dutch veya sport; match değeri exact, llm veya sport
title, categoryOlay veya piyasa ve kategorisi
ends_at, days_left, starts_atUzlaşma zamanı, uzlaşmaya kalan gün, maç başlangıcı
size_usd, fees_usd, shares$ cinsinden işlem büyüklüğü ve komisyonlar, pay sayısı
profit_usd, profit_pct, apr_pct$ ve % cinsinden kâr, APR; bir günden kısa sürede apr_pct null olur
edge_cents, risksPay başına sent cinsinden fiyat avantajı, risk kodları
legs[].platform, market, outcomeBacağın platformu, piyasası ve sonucu
legs[].sideyes veya no — ne alınacağı; bet — oranlı bahis
legs[].price_best, price_avg, price_worstEmir defterinde ilerlerken en iyi, ortalama ve en kötü fiyat
legs[].shares, cost_usd, fee_usd, urlBacağın payları, maliyeti, komisyonu ve piyasa bağlantısı

Bacak fiyatı doların bir kesridir: sonucu gerçekleşen pay $1 getirir, yani 0.997 99,7 sent demektir. İki platform da aynı şekilde uzlaşırsa, ne olursa olsun bir bacak kazanır ve shares alacağınız tutardır. rules_differ, platformların uzlaşma kurallarının farklı olabileceği anlamına gelir; end_mismatch, uzlaşma tarihlerinin farklı olduğunu gösterir.

Örnekte 107.356,85 − 107.175,08 − 28,08 = 153,69 $ kâr, yani 153,69 / 107.203,16 = %0,14. Para uzlaşmaya kadar 562,87 gün kilitli kalır, dolayısıyla yıllık oran 0,14 × 365 / 562,87 ≈ %0,1 çıkar. max_days filtresi bu tür paketleri eler.

sport modu: surebet'ler

Bir sport satırı, tek maçın tek piyasasıdır: farklı platformlarda 2 veya 3 bacak, birlikte tüm sonuçları kapsar. Toplam 13 platform var: 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 listeden çıkar.

Örnek amaçlı: dokümantasyondan, fiyatları yeniden hesaplanmış bir mode=sport satırı.

{
  "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"
    }
  ]
}
AlanAnlamı
sport, league, teams, flagsSpor dalı, lig, takımlar, maç etiketleri
market_typeWIN — sonuç, HCP — handikap, TOT — toplam, BTTS — iki takım da gol atar, CS — kesin skor
period, line, scoreUzlaşma periyodu, handikap veya toplam çizgisi, CS için skor
legs[].coversBacağın kapsadığı sonuçlar: O — üst, U — alt
legs[].oddsOndalık oran; YES veya NO alımında null
legs[].stake_unitBahis payı: bacak kazanırsa $1 almak için ona ne kadar yatırılacağı, komisyonlar dahil
legs[].currencyPlatformun para birimi

Oranlı bahiste stake_unit = 1 / odds: 1 / 2,12 = 0,471698. Bacakların bahis payları toplamı 0,505 + 0,471698 = 0,976698, yani 1'in altında; kâr da 1 / 0,976698 − 1 = %2,39. Kendi tutarınızı bölmek için: bacak bahsi = tutar × stake_unit / Σ stake_unit.

size_usd, tahmin platformlarındaki emir defterlerinin kaldırabildiği alım tutarıdır. 0,505'ten 1.000 $ ile "Over 2.5" için 1.000 / 0,505 ≈ 1.980,2 YES payı alınır. "Under 2.5"in aynı tutarı geri ödemesi için Fonbet bahsi 1.980,2 × 0,471698 ≈ 934,06 $ olur.

Fonbet bahisleri rubleyle alır (currency = RUB): tutarı kendi kurunuzla çevirin, çünkü döviz çevrimi profit_pct içinde yoktur. Burada profit_usd null'dur, çünkü bahis platformu limitini yayımlamaz.

Platform durumu

/predictions/platforms, arbitraj verisinin ne kadar taze olduğunu gösterir. Parametre almaz; data iki liste içerir:

{
  "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"
    }
  ]
}

Bir platformu down olan veya ok = false olan paketleri atlamak en iyisidir: fiyatları değişmiş olabilir.

Analitik, akıllı para, işlemler ve trader'lar

Pro ve Max'teki dört endpoint, Analitik ve Akıllı Para rehberlerindeki ekranları yansıtır.

EndpointParametrelerİçeriği
/predictions/analyticsyokKPI'lar, 1 saatlik ve 24 saatlik fiyat hareketleri, para akışları, yakında uzlaşacak ve yeni piyasalar
/predictions/smart-moneyyokKPI'lar, para akışları, insiders, concentration, smart_vs_price
/predictions/tradesperiod, wallet, category, side, min_usd, insiderPolymarket işlemleri, en yenisi başta
/predictions/tradersperiod: 30d (varsayılan), 7d, allPnL'e göre ilk 300 Polymarket trader'ı

insider etiketi bir cüzdanın davranış kalıbını tanımlar ve hiçbir şeyi kanıtlamaz: deneyimli bir trader'ın yeni adresi de aynı şekilde işlem yapabilir.

İşlem akışı parametreleri; eşiği period belirler:

ParametreTürNe yapar
periodstringlive (varsayılan) — 1.000 $'dan itibaren işlemler, akıllı cüzdanda 100 $'dan; today ve 7d — 5.000 $'dan itibaren taker'lar
walletstringTek bir cüzdanın işlemleri
categorystringPiyasa kategorisi
sidestringbuy veya sell
min_usdnumberAsgari işlem tutarı, $
insiderbooleantrue — yalnızca insider etiketli işlemler
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 ve ask_now, sonucun güncel fiyatlarıdır: bu işlemi şimdi takip etmek 0,83'e mal olur, yani trader'ın ödediğinden 1¢ fazla.

/predictions/traders, tüm zaman, 30 ve 7 günlük PnL'i (pnl_usd), roi_pct, resolved içinden won değerini ve pnl_series mini grafiğini verir. Sıralamadaki bir adresi işlem akışının wallet parametresine yazın.

Nasıl kullanılır

  1. Planınızı ve platformları kontrol edin

    /account/usage planınızı, /predictions/platforms ise fiyatların ne kadar taze olduğunu gösterir.

  2. Paketleri filtrelerle isteyin

    min_profit_pct ve max_days, gürültüyü ve uzun vadeli paketleri eler.

  3. Riskleri ve kuralları kontrol edin

    rules_differ varsa her iki platformun uzlaşma kurallarını okuyun.

  4. Planınızın tazelik süresinden daha sık sorgulamayın

    En az meta.freshness_sec aralığı kullanın ve ETag değerini If-None-Match içinde geri gönderin: 304 yanıtı kotadan düşmez.

  5. İşlemi kendiniz yapın

    Piyasayı legs[].url bağlantısından açın ve fiyatı emir defterinde kontrol edin.

Aynı exact isteği Python'da:

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 veya mod API planınıza dahil değil")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"Paket: {body['meta']['count']}, veri zamanı {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} g · {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("   riskler:", ", ".join(b["risks"]))

Sitede aynı paketler Tahmin arbitrajı ve Sport modu rehberlerinde anlatılır; platformların resmi API'leri — Polymarket ve Kalshi API'leri ile API üzerinden bahis oranları yazılarında.

Sorular ve cevaplar

Genesis API ile kontrat alabilir veya bahis yapabilir miyim?

Hayır. Genesis API yalnızca veri okur ve emir vermez: işlemleri ve bahisleri platformlarda kendiniz yaparsınız.

Surebet'te profit_usd neden null?

Bacaklardan en az biri oranlı bir bahistir ve platform limitini yayımlamaz. Kâr yüzdesi bellidir; her bacağın tutarını stake_unit üzerinden hesaplayın.

API canlı (live) surebet içeriyor mu?

Hayır, yalnızca maç öncesi. Canlının neden daha riskli olduğu maç öncesi ve canlı yazısında anlatılır.

Surebet için hangi plan gerekir?

Pro veya Max: Start'ta mode=sport, 403 plan_restricted döndürür. Fiyatlar Genesis API Fiyatları sayfasında.