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
| Endpoint | Ne döndürür | API planları |
|---|---|---|
/predictions/arbitrage | Arbitraj paketleri ve surebet'ler | Start, Pro, Max; llm ve sport modları — Pro, Max |
/predictions/platforms | Platform durumu | Start, Pro, Max |
/predictions/analytics | KPI'lar, fiyat hareketleri, para akışları | Pro, Max |
/predictions/smart-money | Büyük işlemler, balinalar, insider kalıpları | Pro, Max |
/predictions/trades | Polymarket işlem akışı | Pro, Max |
/predictions/traders | PnL'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.
mode | Ne alırsınız | kind | Planlar |
|---|---|---|---|
exact | İki platformdaki aynı olay, varsayılan | cross | Start, Pro, Max |
dutch | Tek platformda bir olayın sonuç kümesi | dutch | Start, Pro, Max |
llm | Yapay zekâ ile doğrulanmış olay çiftleri | cross | Pro, Max |
sport | Maçlarda surebet'ler | sport | Pro, 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
| Parametre | Tür | Ne yapar |
|---|---|---|
mode | string | exact (varsayılan), dutch, llm veya sport |
category | string | Kategori, category alanındaki gibi |
platform | string | En az bir bacak bu platformda; birden fazlası virgülle ayrılır |
min_profit_pct | number | Asgari kâr, % |
min_profit_usd | number | Asgari kâr, $; profit_usd = null olan satırlar atlanır |
min_apr | number | Asgari APR, % |
max_days | number | Uzlaşmaya en fazla bu kadar gün kalmış |
sport, league | string | mode=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"
}
]
}
| Alan | Anlamı |
|---|---|
id, first_seen, updated_at | Sabit kimlik, paketin ortaya çıktığı ve güncellendiği an |
kind, match | cross, dutch veya sport; match değeri exact, llm veya sport |
title, category | Olay veya piyasa ve kategorisi |
ends_at, days_left, starts_at | Uzlaş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, risks | Pay başına sent cinsinden fiyat avantajı, risk kodları |
legs[].platform, market, outcome | Bacağın platformu, piyasası ve sonucu |
legs[].side | yes veya no — ne alınacağı; bet — oranlı bahis |
legs[].price_best, price_avg, price_worst | Emir defterinde ilerlerken en iyi, ortalama ve en kötü fiyat |
legs[].shares, cost_usd, fee_usd, url | Bacağı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"
}
]
}
| Alan | Anlamı |
|---|---|
sport, league, teams, flags | Spor dalı, lig, takımlar, maç etiketleri |
market_type | WIN — sonuç, HCP — handikap, TOT — toplam, BTTS — iki takım da gol atar, CS — kesin skor |
period, line, score | Uzlaşma periyodu, handikap veya toplam çizgisi, CS için skor |
legs[].covers | Bacağın kapsadığı sonuçlar: O — üst, U — alt |
legs[].odds | Ondalık oran; YES veya NO alımında null |
legs[].stake_unit | Bahis payı: bacak kazanırsa $1 almak için ona ne kadar yatırılacağı, komisyonlar dahil |
legs[].currency | Platformun 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"
}
]
}
platforms[].mode— tahmin platformunun besleme modu:ws,restveya besleme çalışmıyorsadown.quotes_atvefull_scan_at— son fiyatların ve son tam piyasa taramasının zamanı;marketsvehot_markets— toplam piyasa ve sıcak piyasa sayısı.bookmakers[]— bahis platformları:ok— toplama çalışıyor mu,eventsvematched_events— toplam olay ve diğer platformlarla eşleşen olay sayısı,currency— bahis para birimi.
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.
| Endpoint | Parametreler | İçeriği |
|---|---|---|
/predictions/analytics | yok | KPI'lar, 1 saatlik ve 24 saatlik fiyat hareketleri, para akışları, yakında uzlaşacak ve yeni piyasalar |
/predictions/smart-money | yok | KPI'lar, para akışları, insiders, concentration, smart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | Polymarket işlemleri, en yenisi başta |
/predictions/traders | period: 30d (varsayılan), 7d, all | PnL'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:
| Parametre | Tür | Ne yapar |
|---|---|---|
period | string | live (varsayılan) — 1.000 $'dan itibaren işlemler, akıllı cüzdanda 100 $'dan; today ve 7d — 5.000 $'dan itibaren taker'lar |
wallet | string | Tek bir cüzdanın işlemleri |
category | string | Piyasa kategorisi |
side | string | buy veya sell |
min_usd | number | Asgari işlem tutarı, $ |
insider | boolean | true — 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
Planınızı ve platformları kontrol edin
/account/usageplanınızı,/predictions/platformsise fiyatların ne kadar taze olduğunu gösterir.Paketleri filtrelerle isteyin
min_profit_pctvemax_days, gürültüyü ve uzun vadeli paketleri eler.Riskleri ve kuralları kontrol edin
rules_differvarsa her iki platformun uzlaşma kurallarını okuyun.Planınızın tazelik süresinden daha sık sorgulamayın
En az
meta.freshness_secaralığı kullanın veETagdeğeriniIf-None-Matchiçinde geri gönderin:304yanıtı kotadan düşmez.İşlemi kendiniz yapın
Piyasayı
legs[].urlbağ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.