Genesis Arbitrage

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

Funding rate API: हर एक्सचेंज की दरें एक रिक्वेस्ट में, साथ में चुकाई गई funding की हिस्ट्री

संक्षेप में

  • Funding rate API को हर एक्सचेंज के लिए प्रति अवधि दर, अवधि खुद, अगला funding समय, 8 घंटे के हिसाब से दर और फ़्यूचर्स कीमत लौटानी चाहिए।
  • Binance, Bybit, OKX और Hyperliquid के अपने endpoint, इकाइयां और अवधि बताने के तरीके हैं। Genesis API का /funding/rates हर एक्सचेंज की दरें एक GET रिक्वेस्ट में लौटाता है, प्रतिशत में और 8 घंटे पर नॉर्मलाइज़्ड।
  • 13 एक्सचेंज की चुकाई गई funding की हिस्ट्री — योग, औसत दरें, APR, एक साल के दैनिक योग और फ़ीस के बाद net वाला बंडल स्क्रीनर — Pro और Max प्लान में /funding/analytics/* में है।

Funding rate API एक्सचेंज के अनुसार पर्पेचुअल फ़्यूचर्स की funding rate लौटाता है: प्रति अवधि दर, अवधि खुद और अगला funding समय, और पूरे संस्करण में चुकाई गई funding की हिस्ट्री। हर एक्सचेंज का अपना API है, जिसके पाथ, इकाइयां और अवधियां अलग हैं। इसलिए तुलना के लिए दरों को एक टेबल में जमा करते हैं, प्रतिशत में बदलते हैं और एक अवधि पर, आमतौर पर 8 घंटे पर, नॉर्मलाइज़ करते हैं।

Funding rate API को क्या लौटाना चाहिए

अवधि के बिना दर कुछ नहीं बताती: हर 4 घंटे पर 0.02% और हर 8 घंटे पर 0.02% में दो गुना का फ़र्क है। इसीलिए काम का crypto funding rates API हर कॉइन–एक्सचेंज जोड़ी के लिए पांच मान लौटाता है।

क्या चाहिएक्यों/funding/rates फ़ील्ड
प्रति अवधि दरअगला भुगतान कितना होगाfunding_pct
Funding अवधिइसके बिना दरों की तुलना नहीं हो सकतीinterval
अगला funding समयतब तक पोज़िशन खुली होनी चाहिएnext_payout
प्रति 8 घंटे दरअलग-अलग अवधि वाले एक्सचेंजों की तुलनाfunding_8h_pct
फ़्यूचर्स कीमतदोनों लेग की कीमत का अंतर आपकी एंट्री बदल देता हैprice

भुगतान पोज़िशन के आकार गुणा दर के बराबर है: 0.01% पर 10,000 डॉलर की पोज़िशन हर settlement में एक डॉलर पाती या देती है।

एक्सचेंजों की अवधि अलग क्यों है और दर को 8 घंटे पर नॉर्मलाइज़ कैसे करें

हर एक्सचेंज खुद तय करता है कि funding कितनी बार settle हो, और किसी एक कॉन्ट्रैक्ट की अवधि बदल भी सकता है। Genesis API के एनालिटिक्स में CEX की अवधियां 8 और 4 घंटे हैं, जबकि Hyperliquid और Lighter हर घंटे settle करते हैं। Hyperliquid दर को 8 घंटे की दर के रूप में निकालता है और उसका आठवां हिस्सा हर घंटे चुकाता है, जैसा Hyperliquid के funding नियमों में बताया गया है।

Genesis API डॉक्यूमेंटेशन के उदाहरण में MEXC, TON पर हर 4 घंटे में 0.02% लेता है: 0.02 × 8 / 4 = प्रति 8 घंटे 0.04%। घंटे की अवधि वाला एक काल्पनिक उदाहरण: एक्सचेंज A हर घंटे 0.004% देता है, एक्सचेंज B हर 8 घंटे में 0.02%। कच्चे अंकों में A पांचवां हिस्सा देता है, पर 8 घंटे में 0.004 × 8 / 1 = 0.032% बनता है, जबकि B का 0.02%, यानी 1.6 गुना ज़्यादा।

नॉर्मलाइज़ेशन मानता है कि दर पूरी अवधि में वही रहेगी, जबकि घंटे की दर अगले ही settlement पर बदल सकती है। असल में क्या चुकाया गया, यह सिर्फ़ हिस्ट्री बताती है।

APR 8 घंटे की दर से निकलता है: दिन में तीन settlement, साल में 1,095। एक्सचेंज A के लिए यह 0.032 × 3 × 365 = 35.04% सालाना है, जब तक दर वही रहे।

एक्सचेंजों के funding rate API: Binance, Bybit, OKX और Hyperliquid

हर बड़े एक्सचेंज का अपना funding rate API है: अपने पाथ, फ़ील्ड और अवधि बताने का अपना तरीका।

एक्सचेंजमौजूदा दरहिस्ट्रीअवधि
BinanceGET /fapi/v1/premiumIndexGET /fapi/v1/fundingRateGET /fapi/v1/fundingInfo
BybitGET /v5/market/tickersGET /v5/market/funding/historyफ़ील्ड fundingIntervalHour
OKXGET /api/v5/public/funding-rateGET /api/v5/public/funding-rate-historyfundingTime और nextFundingTime से
HyperliquidPOST /info, metaAndAssetCtxsPOST /info, fundingHistoryहर घंटे

Binance funding rate API दर और अगला funding समय premiumIndex के फ़ील्ड lastFundingRate और nextFundingTime में लौटाता है (Binance डॉक्स), और Binance की ऐतिहासिक funding दरें fundingRate से आती हैं, जो startTime और endTime लेता है (funding rate हिस्ट्री). fundingInfo अवधि सिर्फ़ उन कॉन्ट्रैक्ट की लौटाता है जिनकी अवधि या दर की सीमा एक्सचेंज ने बदली है (endpoint का विवरण).

Bybit fundingRate, nextFundingTime और fundingIntervalHour को category=linear वाले एक tickers रिस्पॉन्स में लौटाता है (Bybit tickers), और उसकी हिस्ट्री रिक्वेस्ट में symbol ज़रूरी है (Bybit funding हिस्ट्री). जैसा डॉक्स बताते हैं, हर कॉन्ट्रैक्ट की अपनी अवधि है।

OKX के लिए डॉक्स सुझाते हैं कि कॉन्ट्रैक्ट की अवधि nextFundingTime और fundingTime के अंतर से निकालें (OKX डॉक्स).

Hyperliquid डेटा की सभी रिक्वेस्ट POST https://api.hyperliquid.xyz/info पर लेता है, और JSON बॉडी तय करती है कि क्या लौटेगा: {"type": "metaAndAssetCtxs"} हर एसेट का मौजूदा funding देता है, {"type": "fundingHistory", "coin": "ETH", "startTime": …} दरों की हिस्ट्री देता है (Hyperliquid डॉक्स).

इन एक्सचेंजों को एक टेबल में मिलाने के लिए आपके कोड को यह करना होगा:

हर एक्सचेंज एक रिक्वेस्ट में: /funding/rates

GET /funding/rates हर कॉइन के लिए मौजूदा दर के साथ एक्सचेंजों की सूची लौटाता है: Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, HTX, Hyperliquid और Genesis Arbitrage के कवर किए अन्य एक्सचेंज, कुल मिलाकर 1000+ कॉइन। फ़िल्टर coin और exchange (कई एक्सचेंज के लिए कॉमा से अलग) वैकल्पिक हैं; उनके बिना पूरा सेट मिलता है।

curl --compressed \
  "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"
    }
  ]
}

यह उस envelope के भीतर data ऐरे का एक तत्व है जो Genesis API के सभी रिस्पॉन्स में साझा है: success, data, meta। दरें प्रतिशत में हैं, next_payout भुगतान का समय है HH:MM UTC में, खाली मान null हैं, और Hyperliquid Hyper नाम से आता है। सभी फ़ील्ड और «आज़माएं» फ़ॉर्म डॉक्यूमेंटेशन के फंडिंग दरें सेक्शन में हैं।

/funding/rates और /funding/spread हर प्लान में हैं, 20 डॉलर प्रति माह वाले Trial से शुरू: 500K कॉल, प्रति सेकंड 1 रिक्वेस्ट, डेटा की ताज़गी 60 सेकंड (Genesis API की कीमतें).

Funding spread: /funding/spread

Funding spread एक कॉइन की एक्सचेंजों में सबसे ऊंची और सबसे नीची दर का अंतर है, 8 घंटे पर नॉर्मलाइज़ करने के बाद। शॉर्ट वहां लिया जाता है जहां दर ज़्यादा है और लॉन्ग वहां जहां कम: शॉर्ट को अपने एक्सचेंज की दर मिलती है, लॉन्ग अपने एक्सचेंज की दर चुकाता है (या वह दर नकारात्मक हो तो पाता है), और जो अंतर बचता है वही कमाई है।

GET /funding/spread हर कॉइन के लिए best में सबसे अच्छी एक्सचेंज जोड़ी लौटाता है: exchange_1 और exchange_2, अपनी-अपनी अवधि के हिसाब से उनकी दरें (funding_1_pct, funding_2_pct), अवधियां, भुगतान समय और टर्मिनल लिंक। जोड़ी का spread spread_pct में है, बाकी एक्सचेंज others में, और फ़िल्टर coin और min_spread हैं (Funding spread डॉक्स)। जोड़ी की अवधियां अक्सर अलग होती हैं, जैसे डॉक्यूमेंटेशन के उदाहरण में BTC के लिए 1h और 8h, इसलिए जोड़ी की दरों की तुलना हाथ से तभी करें जब उन्हें 8 घंटे पर नॉर्मलाइज़ कर लिया हो।

Python: टॉप 10 funding spread, वार्षिकीकृत

स्क्रिप्ट /funding/rates का पूरा सेट लेती है और हर कॉइन के लिए सबसे ऊंचे और सबसे नीचे funding_8h_pct वाले एक्सचेंज ढूंढती है: अंतर 8 घंटे का spread है, जिसे spread × 3 × 365 से वार्षिक किया जाता है। 429 और 503 पर वह Retry-After सेकंड रुकती है, पर एक मिनट से ज़्यादा नहीं: मासिक कोटा खत्म होने पर Retry-After कोटा रीसेट होने तक चलता है।

import os
import time
import requests

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


def fetch_rates():
    for _ in range(3):
        r = requests.get(URL, headers=HEADERS, timeout=20)
        if r.status_code not in (429, 503):
            r.raise_for_status()
            return r.json()["data"]
        # 429 या 503: Retry-After तक रुकें, पर एक मिनट से ज़्यादा नहीं
        time.sleep(min(int(r.headers.get("Retry-After", "5")), 60))
    raise RuntimeError("API did not respond after three attempts")


rows = []
for item in fetch_rates():
    ex = [e for e in item["exchanges"]
          if e["funding_8h_pct"] is not None]
    if len(ex) < 2:
        continue
    short = max(ex, key=lambda e: e["funding_8h_pct"])  # शॉर्ट लेग
    long_ = min(ex, key=lambda e: e["funding_8h_pct"])  # लॉन्ग लेग
    spread = short["funding_8h_pct"] - long_["funding_8h_pct"]
    rows.append((spread, item["coin"], short, long_))

rows.sort(key=lambda x: x[0], reverse=True)
for spread, coin, short, long_ in rows[:10]:
    apr = spread * 3 * 365  # एक लेग के नोशनल पर सरल APR
    print(f"{coin:<10} short {short['exchange']:<8} "
          f"long {long_['exchange']:<8} {spread:.4f}% per 8h  "
          f"APR {apr:.1f}%, on capital {apr / 2:.1f}%")

यहां वार्षिक आंकड़ा एक लेग के नोशनल पर है। दोनों लेग को पैसा चाहिए, इसलिए बिना लीवरेज की कुल पूंजी पर रिटर्न आधा है, जैसा एनालिटिक्स के apr_capital फ़ील्ड में। एक काल्पनिक उदाहरण: एक एक्सचेंज पर 8 घंटे में 0.05% पर शॉर्ट, दूसरे पर 0.01% पर लॉन्ग। Spread 0.05 − 0.01 = 0.04% है, वार्षिक 0.04 × 3 × 365 = प्रति लेग 43.8% और पूंजी पर 21.9%।

फ़ीस शामिल नहीं है। एक काल्पनिक उदाहरण: चारों ट्रेड (दोनों लेग खोलना और बंद करना) में से हर एक पर 0.05% taker फ़ीस मिलाकर 4 × 0.05 = एक लेग के नोशनल का 0.2% होती है। 0.04% का spread इसे 0.2 / 0.04 = 5 settlement में, यानी 40 घंटे में, वसूल कर लेता है, अगर दरें टिकी रहें।

कोटे में सिर्फ़ 200 रिस्पॉन्स गिना जाता है। मॉनिटर में हर meta.freshness_sec सेकंड में एक बार से ज़्यादा पोल न करें और पिछला ETag If-None-Match में भेजें: न बदला हुआ पूरा सेट बिना बिल वाले 304 के रूप में लौटता है। ज़्यादा जानकारी लिमिट गाइड में और Crypto API कोर्स के पाठ 4 में है, जो Python में spread और funding मॉनिटर बनाता है।

चुकाई गई funding की हिस्ट्री: /funding/analytics/*

मौजूदा दर अगला settlement दिखाती है; हिस्ट्री दिखाती है कि असल में क्या चुकाया गया। यह चार analytics endpoint से आती है: 13 एक्सचेंज, दरें हर settlement अवधि के लिए प्रतिशत में, टाइमस्टैम्प epoch सेकंड में UTC। ये Pro (100 डॉलर प्रति माह) और Max (200 डॉलर) प्लान में हैं; Trial और Start को 403 plan_restricted मिलता है।

Endpointसामग्रीपूरा सेक्शन
/funding/analytics/summary1 दिन से एक साल तक 7 अवधियों के योग, औसत 8 घंटे की दरें, APR और कवरेज~600 KB gzip
/funding/analytics/recentपिछले 7 दिनों का हर भुगतान~1 MB gzip
/funding/analytics/daily365 दिनों के दैनिक योग~12 MB gzip तक
/funding/analytics/topहर अवधि के लिए टॉप 50 कॉइन×एक्सचेंज जोड़ियां और टॉप 50 शॉर्ट/लॉन्ग बंडल—

coin के बिना पूरे डाउनलोड सीमित हैं: summary और recent हर कुंजी पर 60 सेकंड में एक बार, daily 300 सेकंड में एक बार; विंडो खत्म होने से पहले की रिक्वेस्ट को Retry-After के साथ 429 मिलता है। coin स्लाइस और 304 जवाब सीमित नहीं हैं, इसलिए किसी कॉइन की हिस्ट्री ऐसे लें:

curl --compressed -G \
  "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
  -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Summary में हर कॉइन×एक्सचेंज जोड़ी के साथ अवधि interval_h, डेटा की शुरुआत data_since, «अभी बनाम सामान्य» तुलना के लिए ताज़ा 8 घंटे की दर last8h, और हर अवधि के 14 मेट्रिक का ऐरे m होता है: sum, avg8h, apr, cov, flips और अन्य। डॉक्यूमेंटेशन का उदाहरण: Binance पर BTC, 7 दिन, 21 सकारात्मक settlement, avg8h 0.006298%, apr 0.006298 × 3 × 365 ≈ 6.896%। m, recent और daily को पार्स करना funding endpoint गाइड में है, और फ़ील्ड डॉक्स के फंडिंग एनालिटिक्स सेक्शन में।

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

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

gross अवधि के लिए बंडल की कुल funding है, fees taker_fees टेबल से चार ट्रेड की फ़ीस है, और net = gross − fees। apr_net एक लेग के नोशनल पर वार्षिक है, apr_capital उसका आधा, दोनों लेग की पूंजी पर। win_rate मुनाफ़े वाले दिनों का हिस्सा है, max_dd सबसे बड़ी गिरावट, और price_div दोनों लेग की कीमत का मौजूदा अंतर, जिसे net शामिल नहीं करता।

डॉक्यूमेंटेशन के उदाहरण में PEPE बंडल (HTX पर शॉर्ट, 1000PEPE टिकर से Hyperliquid पर लॉन्ग) ने 7 दिन में gross 1.51504% बनाया, fees 0.19 के साथ। तो net = 1.51504 − 0.19 = 1.32504%, apr_net 69.09% और apr_capital 34.55% है। तैयार सूचियां: शुद्ध यील्ड से by_net_apr, स्थिर बंडल के लिए by_stable, अभी चल रहे बंडल के लिए by_live।

बाज़ार संकेतक के रूप में funding rate

दर सकारात्मक हो तो लीवरेज वाले लॉन्ग शॉर्ट को चुकाते हैं; नकारात्मक हो तो उल्टा। छोटी सकारात्मक दर सामान्य है (Hyperliquid ब्याज वाला घटक प्रति 8 घंटे 0.01% पर तय रखता है), और दर तब संकेत बनती है जब वह अपने सामान्य स्तर से काफ़ी दूर चली जाए।

ऊंची दर को open interest के साथ पढ़ें: दोनों साथ चढ़ें तो एक ही तरफ़ बहुत सारी लीवरेज वाली पोज़िशन जमा हैं, और उनके खिलाफ़ चाल लिक्विडेशन की श्रृंखला शुरू कर देती है। /market/open-interest एक्सचेंज के अनुसार open interest लौटाता है (डॉक्स सेक्शन)। ज़्यादा बाज़ार संकेतक के रूप में funding rate में है।

Funding आर्बिट्राज के जोखिम

दो एक्सचेंज में शॉर्ट/लॉन्ग बंडल कीमत पर लगभग निर्भर नहीं करता, फिर भी इसमें पैसा खोया जा सकता है:

कोड के बिना वही दरें Funding Arbitrage टेबल में हैं (गाइड), spread कैलकुलेटर फ़ीस के साथ बंडल का हिसाब लगाता है, और Crypto API का अवलोकन आम तौर पर बाज़ार डेटा API की तुलना करता है।

सवाल और जवाब

ऐतिहासिक funding दरें कहां से मिलेंगी?

एक्सचेंज हिस्ट्री अपने-अपने फ़ॉर्मेट में रखते हैं: Binance पर GET /fapi/v1/fundingRate, Bybit पर GET /v5/market/funding/history, Hyperliquid पर fundingHistory टाइप। Genesis API 13 एक्सचेंज की हिस्ट्री एक फ़ॉर्मेट में लौटाता है: 7 दिन के भुगतान के लिए /funding/analytics/recent, एक साल के दैनिक योग के लिए /funding/analytics/daily और अवधियों के योग के लिए /funding/analytics/summary, Pro और Max प्लान में।

एक्सचेंजों के बीच funding दरें अलग क्यों होती हैं?

हर एक्सचेंज के अपने ट्रेडर, लिक्विडिटी, दर का फ़ॉर्मूला और सीमाएं हैं, इसलिए पोज़िशन का असंतुलन अलग तरह से बनता है। अवधियां भी अलग हैं: CEX पर 8 या 4 घंटे, Hyperliquid पर हर घंटे। दरों की तुलना एक अवधि पर नॉर्मलाइज़ करके करें; Genesis API में यह funding_8h_pct फ़ील्ड है।

API में funding दरें कितनी बार अपडेट होती हैं?

एक्सचेंज पर मौजूदा दर settlement तक बदलती रहती है; चुकाई गई दर तय हो जाती है और हिस्ट्री में जाती है। Genesis API के डेटा की ताज़गी Trial में 60 सेकंड, Start में 30 सेकंड, Pro में 10 सेकंड और Max में 5 सेकंड है; analytics summary का ETag लगभग हर 15 मिनट में बदलता है, और दैनिक योग हर घंटे दोबारा बनते हैं।

क्या कोई मुफ़्त funding rate API है?

Genesis API में मुफ़्त प्लान नहीं है: funding दरें और spread 20 डॉलर प्रति माह वाले Trial में हैं, हिस्ट्री 100 डॉलर वाले Pro और 200 डॉलर वाले Max में। साइट पर funding दरें और spread बिना प्लान के Funding Arbitrage में दिखते हैं।