Genesis API का मार्केट डेटा: Fair - Last, पंप, OI, AI सिग्नल और सर्च
संक्षेप में
- छह market endpoint साइट जैसे ही हैं: Fair - Last, CEX पंप्स - डंप्स, DEX डंप्स, OI ट्रैकिंग, Genesis AI+ सिग्नल और कॉइन सर्च। DEX डंप्स को छोड़कर सब Trial प्लान से उपलब्ध हैं।
- कीमत और open interest के बदलाव 5 सेकंड से एक घंटे तक के अंतराल पर तैयार प्रतिशत में आते हैं, इसलिए उन्हें पाने के लिए अपना इतिहास सहेजने की ज़रूरत नहीं।
- Genesis API सिर्फ़ डेटा पढ़ता है। यह चालें और विसंगतियाँ दिखाता है, जबकि ट्रेड का फ़ैसला और एक्सचेंज पर ट्रेड खुद आपके हाथ में रहता है।
Genesis API के market endpoint वही डेटा लौटाते हैं जो साइट के Fair - Last, CEX पंप्स - डंप्स, DEX डंप्स और OI ट्रैकिंग सेक्शन में है, साथ में Genesis AI+ का सिग्नल फ़ीड और सभी एक्सचेंज पर कॉइन कार्ड। हर कॉल एक HTTP GET है, key X-API-Key हेडर में जाती है और रिस्पॉन्स data और meta लिफ़ाफ़े में आता है। डेवलपर इस डेटा का उपयोग तेज़ चालों के अलर्ट, open interest मॉनिटर और ट्रेड से पहले कॉइन की जाँच के लिए करते हैं।
Endpoint और प्लान
| Endpoint | क्या लौटाता है | API प्लान |
|---|---|---|
/market/fair-price | मार्क प्राइस और आख़िरी ट्रेड | Trial, Start, Pro, Max |
/market/pumps | CEX पर पंप और डंप | Trial, Start, Pro, Max |
/market/dex-dumps | DEX पर टोकन क्रैश | Pro, Max |
/market/open-interest | एक्सचेंज के हिसाब से open interest | Trial, Start, Pro, Max |
/ai/signals | Genesis AI+ सिग्नल | Trial, Start, Pro, Max |
/coins/search | सभी एक्सचेंज पर कॉइन कार्ड | Trial, Start, Pro, Max |
बेस URL https://api.genesisarbitrage.com/v1 है, और प्लान से बाहर का endpoint 403 plan_restricted लौटाता है। प्लान से डेटा की ताज़गी भी तय होती है: Trial पर 60 सेकंड, Start पर 30 सेकंड, Pro पर 10 सेकंड और Max पर 5 सेकंड। key और पहला रिक्वेस्ट क्विक स्टार्ट में, कोटा Genesis API की सीमाएँ में और एरर कोड Genesis API के रिस्पॉन्स और एरर में हैं।
Fair - Last: /market/fair-price
हर पंक्ति एक एक्सचेंज पर एक कॉइन का फ़्यूचर्स है: मार्क प्राइस (Fair), आख़िरी ट्रेड की कीमत (Last) और दोनों के बीच का स्प्रेड। मार्क प्राइस गणना से बनती है, और Binance Futures पर लिक्विडेशन उसी पर चलता है। बड़ा फ़ासला बताता है कि किसी एक एक्सचेंज के ट्रेड ने Last को धकेला या order book में ऑर्डर खत्म हो गए। ऐसी पंक्तियाँ कैसे जाँचें, यह Fair - Last गाइड में है, और फ़ील्ड डॉक्यूमेंटेशन में।
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
exchange | string | एक्सचेंज; कई हों तो कॉमा से अलग करें |
coin | string | कॉइन का टिकर, जैसे BTC |
min_spread | number | न्यूनतम निरपेक्ष स्प्रेड, % |
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
fair_price / last_price | number | मार्क प्राइस और आख़िरी ट्रेड की कीमत |
spread_pct | number | दोनों के बीच का स्प्रेड, % |
fair_changes / last_changes | object | हर कीमत का बदलाव, %: s5, s10, s30 और m1 — 5, 10 और 30 सेकंड तथा एक मिनट में |
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
-d exchange=ByBit \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
-G फ़्लैग -d पैरामीटर को रिक्वेस्ट URL में डाल देता है। रिस्पॉन्स data ऐरे है; यहाँ और आगे उसका एक आइटम दिखाया गया है:
{
"exchange": "ByBit",
"coin": "0G",
"fair_price": 0.192,
"last_price": 0.192,
"spread_pct": 0.0,
"trade_url": "https://www.bybit.com/trade/usdt/0GUSDT",
"fair_changes": { "s5": 0.0, "s10": 0.052, "s30": 0.052, "m1": 0.0 },
"last_changes": { "s5": 0.052, "s10": 0.052, "s30": 0.052, "m1": 0.0 }
}
CEX पंप्स - डंप्स: /market/pumps
यह endpoint CEX पंप्स - डंप्स तालिका जैसा है: एक्सचेंज के फ़्यूचर्स पर कॉइन की कीमत और आठ अंतरालों पर उसका बदलाव, फ़ील्ड change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m और change_1h में। min_change=5 वाला रिक्वेस्ट उन कॉइन को रखता है जो कम से कम एक अंतराल पर किसी भी दिशा में 5% या ज़्यादा चले। सारे फ़ील्ड endpoint डॉक्यूमेंटेशन में हैं।
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
exchange | string | एक्सचेंज; कई हों तो कॉमा से अलग करें |
coin | string | कॉइन का टिकर |
min_change | number | कीमत के निरपेक्ष बदलाव की सीमा, % |
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
price | number | मौजूदा कीमत |
change_5s … change_1h | number | अंतराल में कीमत का बदलाव, % |
volume_24h | number | 24 घंटे का वॉल्यूम, USD |
funding_pct | number or null | प्रति सेटलमेंट अवधि funding rate, % |
contract / network | string or null | कॉन्ट्रैक्ट पता और टोकन का नेटवर्क |
curl -G "https://api.genesisarbitrage.com/v1/market/pumps" \
-d coin=BTC -d exchange=MEXC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"exchange": "MEXC",
"coin": "BTC",
"price": 64267.9,
"change_5s": 0.0,
"change_10s": 0.0,
"change_30s": 0.02,
"change_60s": 0.06,
"change_5m": 0.08,
"change_15m": -0.06,
"change_30m": -0.09,
"change_1h": -0.2,
"volume_24h": 2243246205,
"funding_pct": 0.01,
"network": "BNB Smart Chain(BEP20)",
"trade_url": "https://futures.mexc.com/exchange/BTC_USDT"
}
DEX डंप्स: /market/dex-dumps
Pro और Max प्लान। यह endpoint DEX डंप्स सेक्शन की तरह DEX पर टोकन क्रैश लौटाता है, साथ में पूल की लिक्विडिटी और यह फ़्लैग कि टोकन CEX पर ट्रेड होता है या नहीं। रिस्पॉन्स की स्कीमा डॉक्यूमेंटेशन में है।
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
chain | string | नेटवर्क, जैसे bsc |
min_liquidity | number | पूल की न्यूनतम लिक्विडिटी, USD |
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
ts | int | इवेंट का समय, unix सेकंड |
price / liquidity_usd | number | कीमत और पूल की लिक्विडिटी, USD |
market_cap | number or null | मार्केट कैप, USD |
price_changes | object | कीमत का बदलाव, %: m5, h1, h6 और h24 |
listed_on_cex | boolean | क्या कॉइन CEX पर ट्रेड होता है |
cex_spot / cex_futures | string[] | वे एक्सचेंज जहाँ कॉइन का स्पॉट और फ़्यूचर्स है |
pool_url | string | पूल का लिंक |
curl -G "https://api.genesisarbitrage.com/v1/market/dex-dumps" \
-d chain=bsc -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"ts": 1783203653,
"coin": "ONLY",
"chain": "bsc",
"price": 0.00009884,
"liquidity_usd": 30477.58,
"market_cap": 98840,
"price_changes": {
"m5": -58.03, "h1": 31.83, "h6": 31.83, "h24": 31.83
},
"pool_url": "https://dexscreener.com/bsc/0x2a18…",
"listed_on_cex": false,
"cex_spot": [],
"cex_futures": []
}
OI ट्रैकिंग: /market/open-interest
Open interest (OI) फ़्यूचर्स की उन पोज़िशन का वॉल्यूम है जो खुली हैं और अभी बंद नहीं हुईं। endpoint इसे OI ट्रैकिंग तालिका की तरह लौटाता है: कॉइन का कुल total में और एक्सचेंज के हिसाब से ब्रेकडाउन exchanges में। डेटा में 13+ फ़्यूचर्स एक्सचेंज हैं, जिनमें Binance, Bybit, OKX, Bitget और Gate शामिल हैं। सार लेख open interest API में है, और फ़ील्ड डॉक्यूमेंटेशन में।
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
coin | string | कॉइन का टिकर |
exchange | string | एक्सचेंज; कई हों तो कॉमा से अलग करें |
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
total.oi_usd / total.oi_tokens | number | open interest डॉलर में और कॉइन में |
total.avg_price | number | सभी एक्सचेंज पर वॉल्यूम-भारित औसत कीमत |
total.volume_24h | number | 24 घंटे का वॉल्यूम, USD |
total.oi_change_5m/15m/30m/1h | number | अंतराल में OI का बदलाव, % |
total.price_change_5m/15m/30m/1h | number | अंतराल में कीमत का बदलाव, % |
exchanges{} | object | यही मीट्रिक हर एक्सचेंज के लिए: avg_price की जगह price, और साथ में trade_url |
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
-d coin=GRAM \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "GRAM",
"total": {
"oi_usd": 96544685.3,
"oi_tokens": 58105803.3,
"avg_price": 1.661224,
"volume_24h": 47010004.63,
"oi_change_1h": 0.3185,
"price_change_1h": -0.1929,
…
},
"exchanges": {
"ByBit": {
"price": 1.6609,
"oi_usd": 26838489.41,
"oi_change_1h": -0.097,
"trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
…
}
}
}
काल्पनिक उदाहरण: एक घंटे में OI 5% से ज़्यादा बढ़ा, कीमत के साथ
आप वे कॉइन चाहते हैं जिनमें पिछले घंटे में नई पोज़िशन आईं और कीमत बढ़ी: total.oi_change_1h 5 से ऊपर और total.price_change_1h 0 से ऊपर। दोनों फ़ील्ड पहले से प्रतिशत में हैं।
एक घंटे पहले कॉइन A का OI $40,000,000 था, अब $42,600,000 है: (42,600,000 − 40,000,000) / 40,000,000 × 100 = 6.5%। उसी घंटे में कीमत $2.00 से $2.056 हुई: (2.056 − 2.00) / 2.00 × 100 = 2.8%। रिस्पॉन्स में यह oi_change_1h: 6.5 और price_change_1h: 2.8 दिखता है।
| कॉइन | OI, 1 घंटा | कीमत, 1 घंटा | नतीजा |
|---|---|---|---|
| A | +6.5% | +2.8% | पास |
| B | +7.2% | −1.9% | नहीं: OI कीमत के उलट बढ़ रहा है |
| C | +3.1% | +4.0% | नहीं: OI सीमा से नीचे है |
कॉइन B में गिरती कीमत पर OI बढ़ रहा है, जिसका आम मतलब है कि शॉर्ट खोले जा रहे हैं। कीमत के साथ OI का बढ़ना चाल जारी रहने का वादा नहीं है: गरम बाज़ार लिक्विडेशन की लड़ी में पलट सकता है।
पूरा स्नैपशॉट माँगें
बिना फ़िल्टर का एक कॉल सारे कॉइन लौटाता है।
छोटे कॉइन हटाएँ
total.oi_usdकी सीमा रखें, जैसे $5,000,000: छोटे OI में दो बड़ी पोज़िशन भी बड़ा प्रतिशत बना देती हैं।शर्त लगाएँ
oi_change_1h5 से ऊपर,price_change_1h0 से ऊपर।चाल का दायरा जाँचें
exchangesमें गिनें कि कितने एक्सचेंज पर OI भी 5% से ज़्यादा बढ़ा: कई जगह बढ़त का वज़न ज़्यादा है।
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
MIN_OI_USD = 5_000_000 # skip small coins
def get(path, **params):
while True:
r = requests.get(API + path, headers=HEADERS,
params=params, timeout=15)
if r.status_code in (429, 503): # rate limit or rebuild
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()["data"]
for row in get("/market/open-interest"):
t = row["total"]
oi, price = t.get("oi_change_1h"), t.get("price_change_1h")
if oi is None or price is None:
continue
if (t.get("oi_usd") or 0) < MIN_OI_USD:
continue
if oi > 5 and price > 0:
wide = [ex for ex, m in row["exchanges"].items()
if (m.get("oi_change_1h") or 0) > 5]
print(f"{row['coin']}: OI {oi:+.1f}%, price {price:+.1f}%, "
f"exchanges with OI growth: {len(wide)}")
Genesis AI+ सिग्नल: /ai/signals
Genesis AI+ आर्बिट्राज सिग्नल जाँचता है और हर एक को alpha से noise तक का ग्रेड देता है। endpoint वही फ़ीड रूसी और अंग्रेज़ी टेक्स्ट तथा बाज़ारों के लिंक के साथ लौटाता है। category एक ही मान लेता है: alpha और high के लिए दो रिक्वेस्ट करें या रिस्पॉन्स अपनी तरफ़ फ़िल्टर करें। फ़ील्ड का विवरण डॉक्यूमेंटेशन में है।
| पैरामीटर | टाइप | क्या करता है |
|---|---|---|
category | string | ग्रेड: alpha, high, middle, risky या noise |
coin | string | कॉइन का टिकर |
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
id | string | पहचानकर्ता: आपका बॉट इससे दोहराव छोड़ता है |
ts / time | int / string | समय: unix सेकंड और ISO 8601 |
pipeline | string | सिग्नल का स्रोत |
message_ru / message_en | string or null | सिग्नल का टेक्स्ट रूसी और अंग्रेज़ी में |
links | array | तैयार लिंक: टेक्स्ट + url |
curl -G "https://api.genesisarbitrage.com/v1/ai/signals" \
-d coin=UTYA \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"id": "1783198680493",
"ts": 1783198680,
"time": "2026-07-04T20:58:00Z",
"coin": "UTYA",
"pipeline": "public",
"category": "noise",
"message_ru": "Глянул на UTYA — DEX против MEXC Futures…",
"message_en": "Checked UTYA — DEX against MEXC Futures…",
"links": [
{
"text": "MEXC Futures",
"url": "https://futures.mexc.com/exchange/UTYA_USDT"
}
]
}
कॉइन सर्च: /coins/search
endpoint साइट के कॉइन सर्च जैसा कॉइन कार्ड लौटाता है: हर नेटवर्क के कॉन्ट्रैक्ट, स्पॉट और फ़्यूचर्स की कीमतें, हर एक्सचेंज पर डिपॉज़िट और विदड्रॉल की स्थिति और funding का सार। टिकर अनिवार्य पैरामीटर query में जाता है, और अनजान कॉइन पर 404 not_found आता है। यहाँ data एक ही ऑब्जेक्ट है। फ़ील्ड डॉक्यूमेंटेशन में हैं।
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
contracts[] | array | कॉन्ट्रैक्ट: पता, नेटवर्क और उसे इस्तेमाल करने वाले एक्सचेंज |
exchanges{}.spot_price / futures_price | number or null | स्पॉट और फ़्यूचर्स की कीमत; null का मतलब बाज़ार नहीं है |
exchanges{}.deposit / withdraw | boolean or null | डिपॉज़िट और विदड्रॉल खुले हैं या नहीं |
funding | object or null | funding का सार; null का मतलब फ़्यूचर्स नहीं हैं |
एक टिकर अलग एक्सचेंज पर अलग टोकन हो सकता है: ट्रांसफ़र से पहले contracts[] के पते को एक्सचेंज के डिपॉज़िट पेज पर दिए कॉन्ट्रैक्ट से मिलाएँ।
curl -G "https://api.genesisarbitrage.com/v1/coins/search" \
-d query=IRYS \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "IRYS",
"contracts": [
{
"address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
"network": "BNB Smart Chain(BEP20)",
"exchanges": ["MEXC", "Ourbit"]
}
],
"exchanges": {
"MEXC": {
"spot_price": 0.01329,
"futures_price": 0.0133,
"deposit": true,
"withdraw": true,
"spot_url": "https://www.mexc.com/exchange/IRYS_USDT",
…
}
},
"funding": {
"spread_pct": 0.0,
"best": { "exchange_1": "Bitget", "exchange_2": "OKX", … }
}
}
सवाल और जवाब
Trial प्लान में कौन से market endpoint हैं?
DEX डंप्स को छोड़कर सब: वह endpoint Pro और Max में खुला है और Trial तथा Start पर 403 plan_restricted लौटाता है।
क्या API में open interest का इतिहास है?
नहीं: endpoint मौजूदा स्नैपशॉट देता है, जिसमें 5, 15 और 30 मिनट तथा एक घंटे के बदलाव हैं, और Genesis API में ऐतिहासिक कैंडल नहीं हैं। इतिहास खुद बनाएँ, रिस्पॉन्स सहेजकर।
क्या इन endpoint से ट्रेड खोले जा सकते हैं?
नहीं। Genesis API सिर्फ़ डेटा पढ़ता है और ऑर्डर नहीं लगाता: ट्रेड आप एक्सचेंज पर खुद खोलते हैं।
market endpoint को कितनी बार पोल करूँ?
meta.freshness_sec से ज़्यादा बार नहीं: Trial पर 60 सेकंड से Max पर 5 सेकंड तक। बिना फ़िल्टर के रिस्पॉन्स में ETag हेडर होता है। उसे If-None-Match में लौटाएँ, और जब तक डेटा नहीं बदला सर्वर 304 देता है, जो आपके कोटे से नहीं कटता।