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
| Endpoint | Hasil | Paket API |
|---|---|---|
/predictions/arbitrage | Bundle arbitrase dan surebet | Start, Pro, Max; mode llm dan sport — Pro, Max |
/predictions/platforms | Status platform | Start, Pro, Max |
/predictions/analytics | KPI, pergerakan harga, aliran dana | Pro, Max |
/predictions/smart-money | Transaksi besar, whale, pola insider | Pro, Max |
/predictions/trades | Aliran transaksi Polymarket | Pro, Max |
/predictions/traders | 300 trader Polymarket teratas berdasarkan PnL | Pro, 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.
mode | Hasil | kind | Paket |
|---|---|---|---|
exact | Event yang sama di dua platform, default | cross | Start, Pro, Max |
dutch | Kumpulan outcome dari satu event di satu platform | dutch | Start, Pro, Max |
llm | Pasangan event yang diverifikasi AI | cross | Pro, Max |
sport | Surebet pada pertandingan | sport | Pro, 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
| Parameter | Tipe | Fungsi |
|---|---|---|
mode | string | exact (default), dutch, llm, atau sport |
category | string | Kategori, seperti pada field category |
platform | string | Minimal satu leg di platform ini; beberapa dipisah koma |
min_profit_pct | number | Profit minimum, % |
min_profit_usd | number | Profit minimum, $; baris dengan profit_usd = null dilewati |
min_apr | number | APR minimum, % |
max_days | number | Maksimal sekian hari hingga settlement |
sport, league | string | Cabang 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"
}
]
}
| Field | Arti |
|---|---|
id, first_seen, updated_at | ID tetap, kapan bundle muncul dan diperbarui |
kind, match | cross, dutch, atau sport; match adalah exact, llm, atau sport |
title, category | Event atau pasar beserta kategorinya |
ends_at, days_left, starts_at | Waktu settlement, hari hingga settlement, awal pertandingan |
size_usd, fees_usd, shares | Ukuran transaksi dan fee dalam $, jumlah share |
profit_usd, profit_pct, apr_pct | Profit dalam $ dan %, APR; apr_pct bernilai null jika kurang dari sehari |
edge_cents, risks | Selisih harga dalam sen per share, kode risiko |
legs[].platform, market, outcome | Platform, pasar, dan outcome leg |
legs[].side | yes atau no — apa yang dibeli; bet — bet dengan odds |
legs[].price_best, price_avg, price_worst | Harga terbaik, rata-rata, dan terburuk saat menelusuri book |
legs[].shares, cost_usd, fee_usd, url | Share, 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"
}
]
}
| Field | Arti |
|---|---|
sport, league, teams, flags | Cabang olahraga, liga, tim, tag pertandingan |
market_type | WIN — hasil, HCP — handicap, TOT — total, BTTS — kedua tim mencetak gol, CS — skor akurat |
period, line, score | Periode settlement, garis handicap atau total, skor untuk CS |
legs[].covers | Outcome yang dicakup leg: O — over, U — under |
legs[].odds | Odds desimal; null untuk pembelian YES atau NO |
legs[].stake_unit | Porsi stake: berapa yang ditaruh pada leg untuk mendapat $1 jika menang, fee sudah termasuk |
legs[].currency | Mata 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"
}
]
}
platforms[].mode— mode feed platform prediksi:ws,rest, ataudownjika feed tidak berjalan.quotes_atdanfull_scan_at— waktu quote terbaru dan pemindaian penuh pasar terakhir;marketsdanhot_markets— total pasar dan pasar yang aktif.bookmakers[]— platform taruhan:ok— apakah pengumpulan berjalan,eventsdanmatched_events— total event dan yang cocok dengan platform lain,currency— mata uang taruhan.
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.
| Endpoint | Parameter | Isinya |
|---|---|---|
/predictions/analytics | tidak ada | KPI, pergerakan harga 1 jam dan 24 jam, aliran dana, pasar yang segera settle, pasar baru |
/predictions/smart-money | tidak ada | KPI, aliran dana, insiders, concentration, smart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | Transaksi Polymarket, terbaru lebih dulu |
/predictions/traders | period: 30d (default), 7d, all | 300 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:
| Parameter | Tipe | Fungsi |
|---|---|---|
period | string | live (default) — transaksi mulai $1.000, mulai $100 untuk smart wallet; today dan 7d — taker mulai $5.000 |
wallet | string | Transaksi satu wallet |
category | string | Kategori pasar |
side | string | buy atau sell |
min_usd | number | Jumlah transaksi minimum, $ |
insider | boolean | true — 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
Periksa paket dan platform Anda
/account/usagemenunjukkan paket Anda,/predictions/platforms— seberapa segar quote-nya.Minta bundle dengan filter
min_profit_pctdanmax_daysmemangkas noise dan bundle berjangka panjang.Periksa risiko dan aturan
Jika ada
rules_differ, baca aturan settlement kedua platform.Polling tidak lebih cepat dari kesegaran paket Anda
Gunakan interval minimal
meta.freshness_secdan kirim balikETagdiIf-None-Match: respons304tidak memakai kuota.Bertransaksi sendiri
Buka pasar dari
legs[].urldan 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.