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/summary | 1 दिन से एक साल तक की अवधियों का सारांश | Pro, Max |
/funding/analytics/recent | 7 दिनों का हर भुगतान | Pro, Max |
/funding/analytics/daily | 365 दिनों के दैनिक योग | 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_pct | 8 घंटे पर नॉर्मलाइज़्ड दर, % |
interval | settlement अवधि, जैसे 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/summary | 7 अवधियों के योग, औसत दरें, APR और कवरेज | ~600 KB gzip | 60 सेकंड में एक बार |
/funding/analytics/recent | 7 दिनों का हर भुगतान | ~1 MB gzip | 60 सेकंड में एक बार |
/funding/analytics/daily | 365 दिनों के दैनिक योग | ~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]
}
}
}
}
}
}
| मीट्रिक | इंडेक्स | अर्थ |
|---|---|---|
sum | 0 | अवधि में जमा, % |
avg8h | 1 | 8 घंटे के हिसाब से औसत दर, % |
apr | 2 | सालाना, % |
n | 3 | settlement की संख्या |
pos, neg, zero | 4–6 | धनात्मक, ऋणात्मक और शून्य settlement |
min, max | 7–8 | सबसे छोटा और सबसे बड़ा settlement, % |
cov | 9 | अवधि का कवरेज 0 से 1 |
med8h | 10 | 8 घंटे के हिसाब से मध्यिका, % |
pos_streak, neg_streak | 11–12 | लगातार धनात्मक और ऋणात्मक दिन |
flips | 13 | चिह्न बदलने की संख्या |
अवधि 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 बेहतर दिखाते हैं। जोड़ी के बाकी फ़ील्ड:
data_since— डेटा कब से शुरू है; इस तारीख से पहले शून्य न खींचें।last8h— 8 घंटे के हिसाब से ताज़ा दर, «अभी बनाम सामान्य» की तुलना के लिए।interval_h— settlement अवधि: CEX पर 8 या 4 घंटे, Hyperliquid और Lighter पर 1 घंटा।canonऔरmult— टिकर के रूपों को जोड़ने वाला नाम (1000PEPE→PEPE) और कॉन्ट्रैक्ट मल्टीप्लायर;multदरों पर कभी लागू नहीं होता।
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 वाली पंक्तियाँ कभी नहीं आतीं।
by_net_apr— शुद्ध यील्ड के हिसाब से।by_stable—win_rate≥ 0.7 और ड्रॉडाउन कुल (gross) के आधे से ज़्यादा नहीं।by_live—live_8h> 0 औरtrend_1d> 0।by_sum_pos,by_sum_neg— जमा funding के हिसाब से एक-एक्सचेंज वाले टॉप, सिर्फ़cov≥ 0.5 के साथ।
| बंडल फ़ील्ड | अर्थ |
|---|---|
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_7d | 8 घंटे पर मौजूदा दर का अंतर और पिछले दिन व सप्ताह का कुल स्प्रेड |
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 मॉनिटर कैसे बनाएँ
उम्मीदवार खोजें
/funding/spreadकोmin_spreadके साथ माँगें (किसी भी API प्लान में) औरspread_pctसे क्रमबद्ध करें।दरें और भुगतान जाँचें
/funding/ratesकोcoinके साथ माँगें: दोनों एक्सचेंज परinterval,next_payoutऔरfunding_8h_pct। पोज़िशन settlement के समय खुली होनी चाहिए।हिस्ट्री देखें
Pro और Max में
/funding/analytics/summaryकोcoinके साथ माँगें: 7d और 30d केsum,apr,covऔरflipsदिखाते हैं कि दरों का अंतर टिकता है या नहीं।बंडल को पूरा आँकें
/funding/analytics/topमेंnet,apr_capital,win_rate,max_ddऔर मौजूदाprice_divकी तुलना करें।पोज़िशन खुद खोलें
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 रिस्पॉन्स सीमित नहीं हैं।