Genesis Arbitrage

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

Genesis API के funding endpoint: दरें, स्प्रेड और funding हिस्ट्री एनालिटिक्स

संक्षेप में

  • /funding/rates और /funding/spread सभी API प्लान में हैं: हर एक्सचेंज की प्रति अवधि और प्रति 8 घंटे की दर, अगले भुगतान का समय और स्प्रेड के हिसाब से सबसे अच्छी एक्सचेंज जोड़ी।
  • Settled funding एनालिटिक्स 13 एक्सचेंज पर एक साल तक की हिस्ट्री वाले चार /funding/analytics/… endpoint हैं, Pro और Max प्लान में।
  • summary, recent और daily के पूरे डाउनलोड gzip में ~12 MB तक के होते हैं और हर 60–300 सेकंड में एक बार की अनुमति है: coin स्लाइस लें या If-None-Match के साथ अनुरोध दोहराएँ।

Genesis API में funding rate API ऐसे endpoint का सेट है जो एक्सचेंजों पर perpetual futures की funding rate, funding स्प्रेड के हिसाब से सबसे अच्छी एक्सचेंज जोड़ी और settled funding की हिस्ट्री देता है। मौजूदा दरें और स्प्रेड सभी API प्लान में हैं; 13 एक्सचेंज की ऐतिहासिक एनालिटिक्स Pro और Max में। साइट यही डेटा Funding Arbitrage में दिखाती है, गाइड देखें।

Funding endpoint और प्लान

Endpointक्या लौटाता हैAPI प्लान
/funding/ratesहर कॉइन के लिए हर एक्सचेंज की दरेंTrial, Start, Pro, Max
/funding/spreadस्प्रेड के हिसाब से सबसे अच्छी एक्सचेंज जोड़ी और बाकी एक्सचेंजTrial, Start, Pro, Max
/funding/analytics/summary1 दिन से एक साल तक की अवधियों का सारांशPro, Max
/funding/analytics/recent7 दिनों का हर भुगतानPro, Max
/funding/analytics/daily365 दिनों के दैनिक योगPro, Max
/funding/analytics/topजोड़ियों और एक्सचेंज बंडलों का स्क्रीनरPro, Max

पैरामीटर और फ़ील्ड दस्तावेज़ के सेक्शन फंडिंग दरें, फंडिंग स्प्रेड और एनालिटिक्स में हैं। Trial और Start में analytics endpoint 403 plan_restricted लौटाते हैं। funding डेटा API के सामान्य परिचय के लिए funding rate API लेख देखें। नीचे के रिस्पॉन्स उदाहरण data फ़ील्ड को छोटा करके दिखाते हैं।

दरें और 8 घंटे पर नॉर्मलाइज़ेशन

/funding/rates हर कॉइन के लिए एक्सचेंजों की सूची मौजूदा दर के साथ लौटाता है। फ़िल्टर coin और exchange (कई एक्सचेंज के लिए कॉमा से अलग) वैकल्पिक हैं।

curl "https://api.genesisarbitrage.com/v1/funding/rates?coin=TON" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}
फ़ील्डअर्थ
funding_pctप्रति settlement अवधि की दर, %
funding_8h_pct8 घंटे पर नॉर्मलाइज़्ड दर, %
intervalsettlement अवधि, जैसे 8h; null — डेटा नहीं
next_payoutअगले भुगतान का समय, HH:MM UTC; null — डेटा नहीं
price, trade_urlकीमत और एक्सचेंज के ट्रेडिंग टर्मिनल का लिंक

एक काल्पनिक उदाहरण: 0.005% की प्रति घंटा दर यानी 0.005 × 8 / 1 = 0.04% प्रति 8 घंटे, MEXC जितनी ही, बस यह आठ बार चुकाई जाती है और अगले घंटे तक बदल सकती है।

बिना चक्रवृद्धि के सालाना करने पर 8 घंटे की दर × 3 × 365 से APR मिलता है। एक काल्पनिक उदाहरण: हर 8 घंटे 0.01% का मतलब 0.01 × 3 × 365 = 10.95% सालाना, जब तक दर बनी रहे। दर बाज़ार के बारे में क्या बताती है, यह बाज़ार संकेतक के रूप में funding rate में है।

Funding स्प्रेड: सबसे अच्छी एक्सचेंज जोड़ी

/funding/spread हर कॉइन के लिए funding स्प्रेड के हिसाब से सबसे अच्छी एक्सचेंज जोड़ी (best) और बाकी एक्सचेंज (others) लौटाता है। फ़िल्टर: coin और min_spread, यानी % में न्यूनतम स्प्रेड।

{
  "coin": "BTC",
  "spread_pct": 0.01,
  "best": {
    "exchange_1": "Hyper",
    "exchange_2": "CoinEx",
    "funding_1_pct": 0.0,
    "funding_2_pct": 0.0,
    "next_payout_1": null,
    "next_payout_2": "08:00",
    "interval_1": "1h",
    "interval_2": "8h",
    "trade_url_1": "https://app.hyperliquid.xyz/trade/BTC",
    "trade_url_2": "https://www.coinex.com/futures/BTC-usdt"
  },
  "others": [ … ]
}

spread_pct सबसे अच्छी जोड़ी का स्प्रेड है, %। funding_1_pct और funding_2_pct अपनी-अपनी अवधि (interval_1, interval_2) की दरें हैं: हाथ से तुलना करने के लिए दोनों को 8 घंटे पर नॉर्मलाइज़ करें। शॉर्ट वहाँ खुलता है जहाँ दर ऊँची है, लॉन्ग वहाँ जहाँ नीची है। रिस्पॉन्स में Hyperliquid Hyper के नाम से आता है।

Python स्क्रिप्ट सबसे ऊँचे spread_pct (0.05% से) वाले दस कॉइन और जोड़ी की settlement अवधियाँ प्रिंट करती है। 429 और 503 पर यह Retry-After सेकंड रुकती है; लूप में हर meta.freshness_sec में एक बार से ज़्यादा अनुरोध न दोहराएँ।

import os
import time
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

for _ in range(3):
    r = requests.get(URL, headers=HEADERS,
                     params={"min_spread": 0.05}, timeout=15)
    if r.status_code not in (429, 503):
        break
    # rate limit या डेटा दोबारा बन रहा है: रुकें और फिर कोशिश करें
    time.sleep(int(r.headers.get("Retry-After", "5")))
r.raise_for_status()

rows = sorted(r.json()["data"], key=lambda x: x["spread_pct"],
              reverse=True)
for row in rows[:10]:
    b = row["best"]
    print(f'{row["coin"]:<10} {row["spread_pct"]:>8.4f}%  '
          f'{b["exchange_1"]} {b["interval_1"]} / '
          f'{b["exchange_2"]} {b["interval_2"]}')

Settled funding एनालिटिक्स

चार /funding/analytics/… endpoint 13 एक्सचेंज पर settled funding की हिस्ट्री लौटाते हैं — वही डेटा जो Funding Arbitrage के एनालिटिक्स टैब में है। दरें प्रति settlement अवधि प्रतिशत में हैं, टाइमस्टैम्प epoch सेकंड में UTC।

Endpointविषय-वस्तुपूरा सेक्शनcoin के बिना, अधिकतम
/funding/analytics/summary7 अवधियों के योग, औसत दरें, APR और कवरेज~600 KB gzip60 सेकंड में एक बार
/funding/analytics/recent7 दिनों का हर भुगतान~1 MB gzip60 सेकंड में एक बार
/funding/analytics/daily365 दिनों के दैनिक योग~12 MB gzip तक300 सेकंड में एक बार
/funding/analytics/topहर अवधि के टॉप-50 जोड़ियाँ और टॉप-50 बंडल—कोई सीमा नहीं

विंडो खत्म होने से पहले पूरा डाउनलोड करने पर Retry-After के साथ 429 मिलता है। ETag और कम्प्रेशन के नियम रिस्पॉन्स फ़ॉर्मेट और एरर गाइड में हैं।

curl --compressed -i \
  "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -H "If-None-Match: <ETag from the previous response>"

--compressed कम्प्रेस्ड रिस्पॉन्स माँगता है और उसे खोल देता है, और -i हेडर प्रिंट करता है, ETag समेत। पहला अनुरोध If-None-Match के बिना भेजें।

Summary और m ऐरे

summary में हर कॉइन×एक्सचेंज जोड़ी में m होता है: कुंजी अवधि है (1d, 3d, 7d, 30d, 90d, 180d, 365d), मान metric_order क्रम में 14 संख्याएँ। अगर किसी अवधि का डेटा बिल्कुल न हो, तो वह m में नहीं होती।

{
  "metric_order": ["sum", "avg8h", "apr", "n", "pos", "neg", "zero",
                   "min", "max", "cov", "med8h", "pos_streak",
                   "neg_streak", "flips"],
  "coins": {
    "BTC": {
      "canon": "BTC",
      "mult": 1,
      "exchanges": {
        "Binance": {
          "interval_h": 8.0,
          "data_since": 1568102400,
          "last8h": 0.004123,
          "m": {
            "7d": [0.12802, 0.006298, 6.896, 21, 21, 0, 0,
                   0.000125, 0.01, 1.0, 0.00588, 7, 0, 0]
          }
        }
      }
    }
  }
}
मीट्रिकइंडेक्सअर्थ
sum0अवधि में जमा, %
avg8h18 घंटे के हिसाब से औसत दर, %
apr2सालाना, %
n3settlement की संख्या
pos, neg, zero4–6धनात्मक, ऋणात्मक और शून्य settlement
min, max7–8सबसे छोटा और सबसे बड़ा settlement, %
cov9अवधि का कवरेज 0 से 1
med8h108 घंटे के हिसाब से मध्यिका, %
pos_streak, neg_streak11–12लगातार धनात्मक और ऋणात्मक दिन
flips13चिह्न बदलने की संख्या

अवधि 1d और 3d में इंडेक्स 10–13 null होते हैं। cov < 0.9 पर डेटा अवधि के एक हिस्से को ही कवर करता है, इसलिए ऐसे मानों पर निशान लगाएँ। उदाहरण में Binance पर BTC के 7 दिन: 21 settlement, सभी धनात्मक, cov 1.0, और apr बराबर avg8h × 3 × 365: 0.006298 × 1095 ≈ 6.896।

अगर avg8h med8h से काफ़ी ऊपर है, तो किसी उछाल ने औसत बढ़ा दिया है: स्थिरता मध्यिका, pos_streak और flips बेहतर दिखाते हैं। जोड़ी के बाकी फ़ील्ड:

7 दिनों के भुगतान और दैनिक योग

/funding/analytics/recent में हर एक्सचेंज के पास ts:rate;ts:rate;… रूप की स्ट्रिंग s है जो समय के बढ़ते क्रम में है, और घंटों में अवधि i है। /funding/analytics/daily में स्ट्रिंग day_ts:sum:pos:neg;… में UTC की आधी रात, दिन का योग और धनात्मक व ऋणात्मक settlement की गिनती होती है।

def parse_recent(s):
    # "ts:rate;ts:rate;…" → [(ts, rate), …]
    return [(int(t), float(v)) for t, v in
            (p.split(":") for p in s.split(";") if p)]


def parse_daily(s):
    # "day_ts:sum:pos:neg;…" → [(day, sum, positive, negative), …]
    out = []
    for p in filter(None, s.split(";")):
        d, total, pos, neg = p.split(":")
        out.append((int(d), float(total), int(pos), int(neg)))
    return out

बंडल स्क्रीनर

/funding/analytics/top बिना पैरामीटर का तैयार स्क्रीनर है: हर अवधि के लिए जमा funding के हिसाब से टॉप-50 कॉइन×एक्सचेंज जोड़ियाँ और टॉप-50 शॉर्ट/लॉन्ग बंडल। बंडल की टाँगें हमेशा अलग एक्सचेंज पर होती हैं, कवरेज कम से कम 0.9, और net ≤ 0 वाली पंक्तियाँ कभी नहीं आतीं।

बंडल फ़ील्डअर्थ
gross, fees, netकुल funding, taker_fees के हिसाब से चार ट्रेड की फ़ीस, और net = gross − fees
apr_net, apr_capitalएक टाँग के नोशनल पर सालाना, और दोनों टाँगों की पूँजी पर apr_net / 2
win_rate, max_ddमुनाफ़े वाले दिनों का हिस्सा (0..1) और संचयी नतीजे का अधिकतम ड्रॉडाउन
worst_streak, risk_daysघाटे वाले दिनों की सबसे लंबी लड़ी और वे दिन जिन पर जोखिम मापा गया, अधिकतम 90
live_8h, trend_1d, trend_7d8 घंटे पर मौजूदा दर का अंतर और पिछले दिन व सप्ताह का कुल स्प्रेड
price_divदोनों टाँगों के बीच मौजूदा कीमत का अंतर; कीमतें न हों तो null
short_sym, long_symएक्सचेंज पर टाँगों के असली टिकर, जो अलग हो सकते हैं: PEPE और 1000PEPE

दस्तावेज़ के उदाहरण में PEPE बंडल — HTX पर शॉर्ट, Hyperliquid पर लॉन्ग — ने 7 दिनों में 1.51504% का gross कमाया। फ़ीस HTX पर खोलने और बंद करने के 0.05% प्रति और Hyperliquid पर 0.045% प्रति है: 0.05 × 2 + 0.045 × 2 = 0.19।

इसलिए net = 1.51504 − 0.19 = 1.32504%, apr_net = 1.32504 × 365 / 7 ≈ 69.09%, apr_capital = 69.09 / 2 ≈ 34.55%। टाँगों के बीच का कीमत अंतर, स्लिपेज और मार्जिन शामिल नहीं हैं।

Funding मॉनिटर कैसे बनाएँ

  1. उम्मीदवार खोजें

    /funding/spread को min_spread के साथ माँगें (किसी भी API प्लान में) और spread_pct से क्रमबद्ध करें।

  2. दरें और भुगतान जाँचें

    /funding/rates को coin के साथ माँगें: दोनों एक्सचेंज पर interval, next_payout और funding_8h_pct। पोज़िशन settlement के समय खुली होनी चाहिए।

  3. हिस्ट्री देखें

    Pro और Max में /funding/analytics/summary को coin के साथ माँगें: 7d और 30d के sum, apr, cov और flips दिखाते हैं कि दरों का अंतर टिकता है या नहीं।

  4. बंडल को पूरा आँकें

    /funding/analytics/top में net, apr_capital, win_rate, max_dd और मौजूदा price_div की तुलना करें।

  5. पोज़िशन खुद खोलें

    trade_url लिंक एक्सचेंज के टर्मिनल पर ले जाते हैं; बंडल की कीमत फ़ीस के साथ स्प्रेड कैलकुलेटर में आँकें।

सवाल और जवाब

Funding rate को 8 घंटे पर कैसे नॉर्मलाइज़ करें?

प्रति अवधि की दर को 8 से गुणा करें और घंटों में अवधि की लंबाई से भाग दें। /funding/rates यह funding_8h_pct फ़ील्ड में आपके लिए कर देता है।

Funding rate की हिस्ट्री कहाँ मिलती है?

/funding/analytics/recent में 7 दिनों का हर भुगतान है, /funding/analytics/daily में एक साल के दैनिक योग, और /funding/analytics/summary में हर अवधि के कुल। तीनों API Pro और Max प्लान में हैं।

पूरा analytics सेक्शन 429 क्यों लौटाता है?

coin के बिना पूरे डाउनलोड सीमित हैं: summary और recent 60 सेकंड में एक बार, daily 300 सेकंड में एक बार प्रति key। Coin स्लाइस और If-None-Match पर 304 रिस्पॉन्स सीमित नहीं हैं।