Genesis API में प्रेडिक्शन बाज़ार और surebet: एंडपॉइंट, फ़िल्टर और फ़ील्ड
संक्षेप में
- छह एंडपॉइंट: प्रेडिक्शन आर्बिट्राज और प्लेटफ़ॉर्म स्थिति Start प्लान से, एनालिटिक्स, स्मार्ट मनी, बड़े ट्रेड और ट्रेडर लीडरबोर्ड Pro और Max पर।
- आर्बिट्राज बंडल ऑर्डर बुक और फ़ीस के साथ पहले से गिने आते हैं: ट्रेड साइज़, $ और % में लाभ, APR, सेटलमेंट तक के दिन और रिस्क कोड।
- sport मोड 13 प्लेटफ़ॉर्म पर surebet देता है, सिर्फ़ मैच से पहले। अगर कोई लेग ऑड्स पर बेट है, तो profit_usd = null रहता है, क्योंकि उस बेट की स्टेक सीमा पता नहीं होती।
Genesis API प्रेडिक्शन बाज़ार का डेटा छह GET एंडपॉइंट से देता है: Polymarket, Kalshi, Limitless, Predict.fun और Opinion के बीच आर्बिट्राज बंडल, 13 प्लेटफ़ॉर्म पर surebet, प्लेटफ़ॉर्म स्थिति, एनालिटिक्स, स्मार्ट मनी, बड़े ट्रेड और ट्रेडर लीडरबोर्ड। यह प्रेडिक्शन आर्बिट्राज, एनालिटिक्स और स्मार्ट मनी पेजों का ही डेटा है, JSON में। इस पर बॉट, डैशबोर्ड या अलर्ट बनाएं; ट्रेड और बेट आप खुद प्लेटफ़ॉर्म पर लगाते हैं।
एंडपॉइंट और प्लान
| एंडपॉइंट | क्या लौटाता है | API प्लान |
|---|---|---|
/predictions/arbitrage | आर्बिट्राज बंडल और surebet | Start, Pro, Max; llm और sport मोड — Pro, Max |
/predictions/platforms | प्लेटफ़ॉर्म स्थिति | Start, Pro, Max |
/predictions/analytics | KPI, कीमत की चाल, मनी फ़्लो | Pro, Max |
/predictions/smart-money | बड़े ट्रेड, व्हेल, इनसाइडर पैटर्न | Pro, Max |
/predictions/trades | Polymarket ट्रेड टेप | Pro, Max |
/predictions/traders | PnL के अनुसार शीर्ष 300 Polymarket ट्रेडर | Pro, Max |
Trial पर छहों 403 plan_restricted लौटाते हैं; Start पर mode=llm और mode=sport वाले रिक्वेस्ट भी यही लौटाते हैं। रिस्पॉन्स का फ़ॉर्मैट रिस्पॉन्स और त्रुटियां गाइड में है, कोटा सीमाएं गाइड में।
प्रेडिक्शन आर्बिट्राज: मोड
mode पैरामीटर तय करता है कि /predictions/arbitrage कौन-से बंडल लौटाए।
mode | क्या मिलता है | kind | प्लान |
|---|---|---|---|
exact | दो प्लेटफ़ॉर्म पर वही इवेंट, डिफ़ॉल्ट | cross | Start, Pro, Max |
dutch | एक प्लेटफ़ॉर्म पर एक इवेंट के नतीजों का सेट | dutch | Start, Pro, Max |
llm | AI से जांचे गए इवेंट जोड़े | cross | Pro, Max |
sport | मैचों पर surebet | sport | Pro, Max |
लाभ पहले से प्लेटफ़ॉर्म की ऑर्डर बुक और फ़ीस के साथ गिना गया है। कम से कम 1% लाभ वाले और 30 दिन में सेटल होने वाले exact बंडल का रिक्वेस्ट:
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
फ़िल्टर
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
mode | string | exact (डिफ़ॉल्ट), dutch, llm या sport |
category | string | श्रेणी, जैसी category फ़ील्ड में है |
platform | string | कम से कम एक लेग इस प्लेटफ़ॉर्म पर; कई हों तो कॉमा से अलग करें |
min_profit_pct | number | न्यूनतम लाभ, % |
min_profit_usd | number | न्यूनतम लाभ, $; जिन पंक्तियों में profit_usd = null है वे छूट जाती हैं |
min_apr | number | न्यूनतम APR, % |
max_days | number | सेटलमेंट तक अधिकतम दिन |
sport, league | string | खेल और लीग, mode=sport के लिए |
फ़िल्टर वैकल्पिक हैं और साथ में चल सकते हैं। प्लेटफ़ॉर्म वैसे लिखें जैसा legs[].platform में है: polymarket, kalshi, fonbet। अज्ञात mode पर 400 bad_request मिलता है।
बंडल और उसके लेग
उदाहरण के लिए: दस्तावेज़ से mode=exact की एक पंक्ति, छोटी की हुई।
{
"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"
}
]
}
| फ़ील्ड | अर्थ |
|---|---|
id, first_seen, updated_at | स्थिर id, बंडल कब दिखा और कब अपडेट हुआ |
kind, match | cross, dutch या sport; match है exact, llm या sport |
title, category | इवेंट या बाज़ार और उसकी श्रेणी |
ends_at, days_left, starts_at | सेटलमेंट का समय, सेटलमेंट तक के दिन, मैच की शुरुआत |
size_usd, fees_usd, shares | $ में ट्रेड साइज़ और फ़ीस, शेयरों की संख्या |
profit_usd, profit_pct, apr_pct | $ और % में लाभ, APR; एक दिन से कम पर apr_pct null होता है |
edge_cents, risks | प्रति शेयर सेंट में कीमत का अंतर, रिस्क कोड |
legs[].platform, market, outcome | लेग का प्लेटफ़ॉर्म, बाज़ार और नतीजा |
legs[].side | yes या no — क्या ख़रीदना है; bet — ऑड्स पर बेट |
legs[].price_best, price_avg, price_worst | बुक से गुज़रने पर सबसे अच्छी, औसत और सबसे बुरी कीमत |
legs[].shares, cost_usd, fee_usd, url | लेग के शेयर, लागत, फ़ीस और बाज़ार का लिंक |
लेग की कीमत $1 का अंश होती है: नतीजा जीते तो शेयर $1 लौटाता है, इसलिए 0.997 यानी 99.7 सेंट। अगर दोनों प्लेटफ़ॉर्म एक ही तरह सेटल करें, तो कुछ भी हो एक लेग जीतता है, और shares वह रकम है जो आपको मिलती है। rules_differ का मतलब है कि प्लेटफ़ॉर्म के सेटलमेंट नियम अलग हो सकते हैं; end_mismatch का मतलब है कि सेटलमेंट की तारीख़ें अलग हैं।
उदाहरण में 107,356.85 − 107,175.08 − 28.08 = $153.69 लाभ है, यानी 153.69 / 107,203.16 = 0.14%। पैसा सेटलमेंट तक 562.87 दिन फँसा रहता है, इसलिए सालाना दर 0.14 × 365 / 562.87 ≈ 0.1% आती है। max_days फ़िल्टर ऐसे बंडल हटा देता है।
sport मोड: surebet
sport पंक्ति एक मैच का एक बाज़ार है: अलग-अलग प्लेटफ़ॉर्म पर 2 या 3 लेग, जो मिलकर उसके सभी नतीजे कवर करते हैं। प्लेटफ़ॉर्म 13 हैं: Polymarket, Kalshi, Predict.fun और 10 बेटिंग प्लेटफ़ॉर्म — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB और Dafa Sports। सिर्फ़ मैच से पहले: मैच शुरू होते ही surebet सूची से हट जाता है।
उदाहरण के लिए: दस्तावेज़ से mode=sport की एक पंक्ति, दोबारा गिनी गई कीमतों के साथ।
{
"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"
}
]
}
| फ़ील्ड | अर्थ |
|---|---|
sport, league, teams, flags | खेल, लीग, टीमें, मैच के टैग |
market_type | WIN — नतीजा, HCP — हैंडिकैप, TOT — टोटल, BTTS — दोनों टीमें स्कोर करें, CS — सही स्कोर |
period, line, score | सेटलमेंट की अवधि, हैंडिकैप या टोटल की लाइन, CS के लिए स्कोर |
legs[].covers | लेग कौन-से नतीजे कवर करता है: O — ओवर, U — अंडर |
legs[].odds | डेसिमल ऑड्स; YES या NO ख़रीद के लिए null |
legs[].stake_unit | स्टेक का हिस्सा: जीतने पर $1 पाने के लिए लेग पर कितना लगाना है, फ़ीस समेत |
legs[].currency | प्लेटफ़ॉर्म की मुद्रा |
ऑड्स पर बेट के लिए stake_unit = 1 / odds: 1 / 2.12 = 0.471698। लेग के स्टेक यूनिट का योग 0.505 + 0.471698 = 0.976698 है, जो 1 से कम है, इसलिए लाभ 1 / 0.976698 − 1 = 2.39% है। अपनी रकम बांटने के लिए leg stake = amount × stake_unit / Σ stake_unit लें।
size_usd प्रेडिक्शन प्लेटफ़ॉर्म पर ख़रीद की वह रकम है जिसे उनकी ऑर्डर बुक झेल सकती हैं। 0.505 पर $1,000 से "Over 2.5" के 1,000 / 0.505 ≈ 1,980.2 YES शेयर मिलते हैं। "Under 2.5" से उतना ही लौटाने के लिए Fonbet की बेट 1,980.2 × 0.471698 ≈ $934.06 है।
Fonbet रूबल में बेट लेता है (currency = RUB): रकम अपने भाव से बदलें, क्योंकि एक्सचेंज profit_pct में शामिल नहीं है। यहां profit_usd null है, क्योंकि बेटिंग प्लेटफ़ॉर्म बेट की स्टेक सीमा प्रकाशित नहीं करता।
प्लेटफ़ॉर्म स्थिति
/predictions/platforms दिखाता है कि आर्बिट्राज डेटा कितना ताज़ा है। इसमें कोई पैरामीटर नहीं है; data में दो सूचियां हैं:
{
"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— प्रेडिक्शन प्लेटफ़ॉर्म का फ़ीड मोड:ws,rest, याdownजब फ़ीड काम नहीं कर रहा।quotes_atऔरfull_scan_at— ताज़ा कोट का समय और बाज़ारों के आख़िरी पूरे स्कैन का समय;marketsऔरhot_markets— कुल बाज़ार और हॉट बाज़ार।bookmakers[]— बेटिंग प्लेटफ़ॉर्म:ok— डेटा संग्रह चल रहा है या नहीं,eventsऔरmatched_events— कुल इवेंट और दूसरे प्लेटफ़ॉर्म से मिलाए गए इवेंट,currency— बेटिंग मुद्रा।
जिन बंडलों में कोई प्लेटफ़ॉर्म down में है या ok = false है, उन्हें छोड़ देना बेहतर है: उनकी कीमतें बदल चुकी हो सकती हैं।
एनालिटिक्स, स्मार्ट मनी, ट्रेड और ट्रेडर
Pro और Max के चार एंडपॉइंट एनालिटिक्स और स्मार्ट मनी गाइड की स्क्रीन को दोहराते हैं।
| एंडपॉइंट | पैरामीटर | अंदर क्या है |
|---|---|---|
/predictions/analytics | कोई नहीं | KPI, 1h और 24h में कीमत की चाल, मनी फ़्लो, जल्द सेटल होने वाले बाज़ार, नए बाज़ार |
/predictions/smart-money | कोई नहीं | KPI, मनी फ़्लो, insiders, concentration, smart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | Polymarket ट्रेड, सबसे नए पहले |
/predictions/traders | period: 30d (डिफ़ॉल्ट), 7d, all | PnL के अनुसार शीर्ष 300 Polymarket ट्रेडर |
insider लेबल वॉलेट के व्यवहार का पैटर्न बताता है और कुछ साबित नहीं करता: अनुभवी ट्रेडर का नया पता भी इसी तरह ट्रेड कर सकता है।
ट्रेड टेप के पैरामीटर; period सीमा तय करता है:
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
period | string | live (डिफ़ॉल्ट) — $1,000 से ट्रेड, स्मार्ट वॉलेट के लिए $100 से; today और 7d — $5,000 से टेकर |
wallet | string | एक वॉलेट के ट्रेड |
category | string | बाज़ार की श्रेणी |
side | string | buy या sell |
min_usd | number | न्यूनतम ट्रेड रकम, $ |
insider | boolean | true — सिर्फ़ 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 और ask_now नतीजे की मौजूदा कीमतें हैं: इस ट्रेड के पीछे अभी चलने में 0.83 लगता है, यानी ट्रेडर के दिए भाव से 1 सेंट ज़्यादा।
/predictions/traders पूरे समय, 30 और 7 दिन का PnL (pnl_usd), roi_pct, resolved में से won और pnl_series स्पार्कलाइन देता है। लीडरबोर्ड का कोई पता ट्रेड टेप के wallet में डालें।
कैसे इस्तेमाल करें
अपना प्लान और प्लेटफ़ॉर्म जांचें
/account/usageआपका प्लान दिखाता है,/predictions/platformsकोट कितने ताज़ा हैं।फ़िल्टर के साथ बंडल मांगें
min_profit_pctऔरmax_daysशोर और दूर की सेटलमेंट वाले बंडल घटाते हैं।रिस्क और नियम जांचें
rules_differहो तो दोनों प्लेटफ़ॉर्म के सेटलमेंट नियम पढ़ें।अपने प्लान की ताज़गी से तेज़ पोल न करें
कम से कम
meta.freshness_secका अंतराल रखें औरETagकोIf-None-Matchमें लौटाएं:304रिस्पॉन्स कोटा नहीं खर्चता।ट्रेड खुद करें
legs[].urlसे बाज़ार खोलें और उसकी ऑर्डर बुक में कीमत जांचें।
वही exact रिक्वेस्ट 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("एंडपॉइंट या मोड आपके API प्लान में शामिल नहीं है")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"बंडल: {body['meta']['count']}, डेटा का समय {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} दिन · {b['title'][:40]}")
for leg in b["legs"]:
print(f" {leg['platform']}: {leg['side']} "
f"{leg['outcome']} कीमत {leg['price_avg']}")
if b["risks"]:
print(" रिस्क:", ", ".join(b["risks"]))
साइट पर यही बंडल प्रेडिक्शन आर्बिट्राज और Sport मोड गाइड में हैं; प्लेटफ़ॉर्म के आधिकारिक API — Polymarket और Kalshi API और API से बेटिंग ऑड्स लेखों में।
सवाल और जवाब
क्या Genesis API से कॉन्ट्रैक्ट ख़रीद या बेट लगा सकता हूं?
नहीं। Genesis API सिर्फ़ डेटा पढ़ता है और कोई ऑर्डर नहीं लगाता: ट्रेड और बेट आप खुद प्लेटफ़ॉर्म पर लगाते हैं।
surebet में profit_usd null क्यों है?
कम से कम एक लेग ऑड्स पर बेट है, और प्लेटफ़ॉर्म उसकी स्टेक सीमा प्रकाशित नहीं करता। लाभ का प्रतिशत पता है; हर लेग की रकम stake_unit से निकालें।
क्या API में लाइव surebet हैं?
नहीं, सिर्फ़ मैच से पहले वाले। लाइव में जोखिम ज़्यादा क्यों है, यह प्रीमैच बनाम लाइव लेख में है।
surebet के लिए कौन-सा प्लान चाहिए?
Pro या Max: Start पर mode=sport 403 plan_restricted लौटाता है। कीमतें Genesis API मूल्य पेज पर हैं।