Genesis Arbitrage

Genesis Arbitrage · · 12 मिनट में पढ़ें

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/pumpsCEX पर पंप और डंपTrial, Start, Pro, Max
/market/dex-dumpsDEX पर टोकन क्रैशPro, Max
/market/open-interestएक्सचेंज के हिसाब से open interestTrial, Start, Pro, Max
/ai/signalsGenesis 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 गाइड में है, और फ़ील्ड डॉक्यूमेंटेशन में।

पैरामीटरटाइपक्या करता है
exchangestringएक्सचेंज; कई हों तो कॉमा से अलग करें
coinstringकॉइन का टिकर, जैसे BTC
min_spreadnumberन्यूनतम निरपेक्ष स्प्रेड, %
फ़ील्डटाइपमतलब
fair_price / last_pricenumberमार्क प्राइस और आख़िरी ट्रेड की कीमत
spread_pctnumberदोनों के बीच का स्प्रेड, %
fair_changes / last_changesobjectहर कीमत का बदलाव, %: 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 डॉक्यूमेंटेशन में हैं।

पैरामीटरटाइपक्या करता है
exchangestringएक्सचेंज; कई हों तो कॉमा से अलग करें
coinstringकॉइन का टिकर
min_changenumberकीमत के निरपेक्ष बदलाव की सीमा, %
फ़ील्डटाइपमतलब
pricenumberमौजूदा कीमत
change_5s … change_1hnumberअंतराल में कीमत का बदलाव, %
volume_24hnumber24 घंटे का वॉल्यूम, USD
funding_pctnumber or nullप्रति सेटलमेंट अवधि funding rate, %
contract / networkstring 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 पर ट्रेड होता है या नहीं। रिस्पॉन्स की स्कीमा डॉक्यूमेंटेशन में है।

पैरामीटरटाइपक्या करता है
chainstringनेटवर्क, जैसे bsc
min_liquiditynumberपूल की न्यूनतम लिक्विडिटी, USD
फ़ील्डटाइपमतलब
tsintइवेंट का समय, unix सेकंड
price / liquidity_usdnumberकीमत और पूल की लिक्विडिटी, USD
market_capnumber or nullमार्केट कैप, USD
price_changesobjectकीमत का बदलाव, %: m5, h1, h6 और h24
listed_on_cexbooleanक्या कॉइन CEX पर ट्रेड होता है
cex_spot / cex_futuresstring[]वे एक्सचेंज जहाँ कॉइन का स्पॉट और फ़्यूचर्स है
pool_urlstringपूल का लिंक
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 में है, और फ़ील्ड डॉक्यूमेंटेशन में।

पैरामीटरटाइपक्या करता है
coinstringकॉइन का टिकर
exchangestringएक्सचेंज; कई हों तो कॉमा से अलग करें
फ़ील्डटाइपमतलब
total.oi_usd / total.oi_tokensnumberopen interest डॉलर में और कॉइन में
total.avg_pricenumberसभी एक्सचेंज पर वॉल्यूम-भारित औसत कीमत
total.volume_24hnumber24 घंटे का वॉल्यूम, USD
total.oi_change_5m/15m/30m/1hnumberअंतराल में OI का बदलाव, %
total.price_change_5m/15m/30m/1hnumberअंतराल में कीमत का बदलाव, %
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 का बढ़ना चाल जारी रहने का वादा नहीं है: गरम बाज़ार लिक्विडेशन की लड़ी में पलट सकता है।

  1. पूरा स्नैपशॉट माँगें

    बिना फ़िल्टर का एक कॉल सारे कॉइन लौटाता है।

  2. छोटे कॉइन हटाएँ

    total.oi_usd की सीमा रखें, जैसे $5,000,000: छोटे OI में दो बड़ी पोज़िशन भी बड़ा प्रतिशत बना देती हैं।

  3. शर्त लगाएँ

    oi_change_1h 5 से ऊपर, price_change_1h 0 से ऊपर।

  4. चाल का दायरा जाँचें

    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 के लिए दो रिक्वेस्ट करें या रिस्पॉन्स अपनी तरफ़ फ़िल्टर करें। फ़ील्ड का विवरण डॉक्यूमेंटेशन में है।

पैरामीटरटाइपक्या करता है
categorystringग्रेड: alpha, high, middle, risky या noise
coinstringकॉइन का टिकर
फ़ील्डटाइपमतलब
idstringपहचानकर्ता: आपका बॉट इससे दोहराव छोड़ता है
ts / timeint / stringसमय: unix सेकंड और ISO 8601
pipelinestringसिग्नल का स्रोत
message_ru / message_enstring or nullसिग्नल का टेक्स्ट रूसी और अंग्रेज़ी में
linksarrayतैयार लिंक: टेक्स्ट + 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_pricenumber or nullस्पॉट और फ़्यूचर्स की कीमत; null का मतलब बाज़ार नहीं है
exchanges{}.deposit / withdrawboolean or nullडिपॉज़िट और विदड्रॉल खुले हैं या नहीं
fundingobject or nullfunding का सार; 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 देता है, जो आपके कोटे से नहीं कटता।