Open interest API: एक्सचेंजों पर futures OI और उसे कैसे पढ़ें
संक्षेप में
- Open interest उन futures पोज़िशनों की मात्रा है जो अभी खुली हैं। कॉइन में गिनने पर यह पोज़िशनों का आना दिखाता है; डॉलर में गिनने पर यह कीमत के साथ भी हिलता है।
- हर एक्सचेंज OI अपने फ़ॉर्मेट और इकाइयों में छापता है। Genesis API में
/market/open-interestकी एक कॉल 13+ एक्सचेंज कवर करती है: कुलtotalमें, एक्सचेंज-वार ब्योराexchangesमें, और OI व कीमत का 5, 15, 30 मिनट और 1 घंटे का बदलाव, सभी प्लान पर। - कीमत और funding के साथ पढ़ने पर OI दिखाता है कि पोज़िशन कौन बना रहा है और उन्हें रखने की कीमत कौन चुका रहा है। यह कीमत का अनुमान नहीं लगाता; फ़ैसला और एक्सचेंज पर ट्रेड आपके हाथ में रहते हैं।
Open interest API हर कॉइन के लिए खुली futures पोज़िशनों की मात्रा लौटाता है, कॉइन और डॉलर में, हर एक्सचेंज के हिसाब से और कुल, साथ में पिछले कुछ मिनटों और घंटों में उसका बदलाव। एक्सचेंज अपने कॉन्ट्रैक्ट का OI अपने API से छापते हैं, और फ़ॉर्मेट एक एक्सचेंज से दूसरे में अलग होते हैं। Genesis API में पूरा स्नैपशॉट /market/open-interest की एक कॉल से आता है: Binance, Bybit, OKX, Bitget और Gate समेत 13+ futures एक्सचेंज, OI और कीमत का 5, 15, 30 मिनट और 1 घंटे का बदलाव, सभी प्लान पर, $20 प्रति माह वाले Trial से शुरू।
Open interest क्या है
Open interest (OI) किसी futures कॉन्ट्रैक्ट की उन पोज़िशनों का कुल जोड़ है जो खुली हैं और अभी बंद नहीं हुईं। हर कॉन्ट्रैक्ट के दो पक्ष होते हैं, long और short, और OI उनमें से एक को गिनता है: एक ट्रेडर 1 BTC long ख़रीदता है, दूसरा 1 BTC short बेचता है, और open interest 1 BTC बढ़ जाता है।
OI तब बढ़ता है जब सौदे के दोनों पक्ष पोज़िशन खोलते हैं, तब घटता है जब दोनों बंद करते हैं, और तब नहीं बदलता जब पोज़िशन एक ट्रेडर से दूसरे को चली जाती है। इसलिए OI बढ़ने का मतलब है कि नई पोज़िशनें आ रही हैं, और घटने का मतलब है कि पोज़िशनें बंद हो रही हैं, अपनी मर्ज़ी से या ज़बरदस्ती।
कॉइन और डॉलर में OI
एक्सचेंज OI को कॉन्ट्रैक्ट, कॉइन या सीधे डॉलर में बताते हैं, और कॉइन को कीमत से डॉलर में बदला जाता है। Genesis API के नमूना रिस्पॉन्स में GRAM के लिए ByBit का oi_usd बराबर है oi_tokens गुणा price के: 16,159,003.8 × 1.6609 = 26,838,489.41।
डॉलर वाला आँकड़ा कॉइनों और एक्सचेंजों की तुलना के लिए सुविधाजनक है, पर वह कीमत के साथ हिलता है। उदाहरण (काल्पनिक): किसी एक्सचेंज पर $1.50 की कीमत पर 2,000,000 कॉइन खुली पोज़िशनों में हैं, तो OI है 2,000,000 × $1.50 = $3,000,000। एक घंटे बाद पोज़िशनें वही हैं, कीमत $1.65 है, और डॉलर OI 2,000,000 × $1.65 = $3,300,000 हो चुका है, यानी एक भी नई पोज़िशन के बिना 10% ऊपर।
कुल OI और एक्सचेंज-वार ब्योरा
किसी कॉइन का कुल OI उन एक्सचेंजों का OI जोड़ता है जिन पर उसके futures लिस्ट हैं, और दिखाता है कि बाज़ार ने पोज़िशनों में कितना पैसा रखा है। ब्योरा दिखाता है कि यह पैसा कहाँ है: उसी रिस्पॉन्स में ByBit के पास GRAM के डॉलर OI का 26,838,489.41 / 96,544,685.3 × 100 = 27.8% है।
| माप | क्या दिखाता है | पेच |
|---|---|---|
| कॉइन में OI | कितनी पोज़िशनें खुली हैं | कॉन्ट्रैक्ट का आकार एक्सचेंज के हिसाब से अलग होता है |
| डॉलर में OI | पोज़िशनों में कितना पैसा है | कीमत के साथ हिलता है |
| कुल OI | पूरे बाज़ार की पोज़िशनें | इस पर निर्भर है कि कौन-से एक्सचेंज जोड़े गए |
| एक्सचेंज-वार OI | पोज़िशनें कहाँ बन रही हैं | एक्सचेंजों के तरीके अलग हैं |
Binance, Bybit, OKX और Hyperliquid के API क्या लौटाते हैं
हर एक्सचेंज अपने कॉन्ट्रैक्ट का OI अपने API से छापता है। आधिकारिक दस्तावेज़ यह कहते हैं:
| एक्सचेंज | मौजूदा OI | OI का इतिहास | ध्यान दें |
|---|---|---|---|
| Binance | GET /fapi/v1/openInterest, हर रिक्वेस्ट में एक symbol | GET /futures/data/openInterestHist | इतिहास केवल पिछले एक महीने का है |
| Bybit | GET /v5/market/tickers, सारे symbol एक रिक्वेस्ट में | GET /v5/market/open-interest, 5min से 1d तक के क़दम | openInterest दोनों पक्ष गिनता है, singleOpenInterest एक पक्ष |
| OKX | GET /api/v5/public/open-interest | GET /api/v5/rubik/stat/contracts/open-interest-history | oi कॉन्ट्रैक्ट में, oiCcy कॉइन में, oiUsd डॉलर में |
| Hyperliquid | POST /info, टाइप metaAndAssetCtxs | दस्तावेज़ में नहीं है | एक रिक्वेस्ट में perpetual futures का OI |
ब्योरा Binance, Bybit, OKX और Hyperliquid के दस्तावेज़ों में है। Binance का इतिहास sumOpenInterest और sumOpenInterestValue के रूप में आता है, जबकि OKX 5 मिनट से शुरू होने वाले क़दमों में आख़िरी 1,440 रिकॉर्ड लौटाता है। Hyperliquid https://api.hyperliquid.xyz/info पर बॉडी {"type": "metaAndAssetCtxs"} वाली रिक्वेस्ट लेता है और हर perpetual के लिए markPx और funding के साथ openInterest लौटाता है।
तरीक़े का फ़र्क़ दोगुना तक हो सकता है। Bybit के /v5/market/open-interest के नमूना रिस्पॉन्स में openInterest 63,910,691 है और singleOpenInterest 31,955,346, ठीक आधा: पहला दोनों पक्ष गिनता है, दूसरा एक पक्ष, जैसा ऊपर OI की परिभाषा में है।
एक स्नैपशॉट ख़ुद बनाने का मतलब है हर एक्सचेंज को उसके नियमों से पोल करना, कॉन्ट्रैक्ट को कॉइन में और कॉइन को डॉलर में बदलना, और हर एक्सचेंज की सीमाओं में रहना। Binance पर इसके लिए हर कॉन्ट्रैक्ट की अलग रिक्वेस्ट चाहिए।
Genesis API में open interest: /market/open-interest
/market/open-interest endpoint वही डेटा लौटाता है जो साइट की OI Tracking टेबल में है: हर कॉइन का कुल OI total में और एक्सचेंज-वार ब्योरा exchanges में। बिना पैरामीटर के सारे कॉइन मिलते हैं; coin एक कॉइन रखता है, और exchange चुने हुए एक्सचेंज रखता है, कई हों तो कॉमा से अलग करके।
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
-d coin=GRAM \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
रिस्पॉन्स एक data ऐरे है। नीचे दस्तावेज़ से उसका एक एलिमेंट है, कुछ फ़ील्ड हटाकर:
{
"coin": "GRAM",
"total": {
"oi_usd": 96544685.3,
"oi_tokens": 58105803.3,
"avg_price": 1.661224,
"volume_24h": 47010004.63,
"oi_change_5m": 0.0196,
"oi_change_1h": 0.3185,
"price_change_5m": -0.0228,
"price_change_1h": -0.1929,
…
},
"exchanges": {
"ByBit": {
"price": 1.6609,
"oi_usd": 26838489.41,
"oi_tokens": 16159003.8,
"oi_change_1h": -0.097,
"price_change_1h": -0.1683,
"trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
…
}
}
}
| फ़ील्ड | मतलब |
|---|---|
total.oi_usd / total.oi_tokens | डॉलर और कॉइन में कुल OI |
total.avg_price | एक्सचेंजों पर कॉइन की औसत कीमत |
total.volume_24h | 24 घंटे का वॉल्यूम, USD |
total.oi_change_5m/15m/30m/1h | 5, 15, 30 मिनट और 1 घंटे में OI का बदलाव, % |
total.price_change_5m/15m/30m/1h | उन्हीं अंतरालों में कीमत का बदलाव, % |
exchanges{} | यही माप हर एक्सचेंज के लिए: avg_price की जगह price, साथ में trade_url |
बदलाव प्रतिशत में हैं: 0.3185 का मतलब 0.3185% है। ख़ाली मान null के रूप में आते हैं, इसलिए उन्हें छोड़ दें। ताज़गी प्लान पर निर्भर है: Trial पर 60 सेकंड, Start पर 30, Pro पर 10 और Max पर 5 सेकंड, इसलिए meta.freshness_sec से ज़्यादा बार पोल करने का कोई फ़ायदा नहीं।
बिना फ़िल्टर वाले रिस्पॉन्स में ETag हेडर होता है। उसे If-None-Match में लौटाएँ, तो न बदला स्नैपशॉट 304 के साथ आता है, जो आपके कोटे से नहीं कटता; तरीक़ा ETag और If-None-Match में समझाया गया है। exchange फ़िल्टर केवल exchanges को सीमित करता है: total फिर भी सभी एक्सचेंजों पर गिना जाता है।
फ़ील्ड, पैरामीटर और «आज़माएं» फ़ॉर्म दस्तावेज़ के "OI Tracking" सेक्शन में हैं। सारे market endpoint उदाहरणों के साथ Genesis API market data गाइड में दिखाए गए हैं।
कीमत के साथ OI पढ़ना: चार परिदृश्य
OI बढ़ना बताता है कि पोज़िशनें खुल रही हैं, पर यह नहीं कि कौन-सा पक्ष चला रहा है। उसी अंतराल की कीमत इशारा देती है।
| कीमत | OI | आम व्याख्या | क्या जाँचें |
|---|---|---|---|
| ऊपर | ऊपर | चाल की दिशा में नई पोज़िशनें, तेज़ी को पैसे का सहारा है | Funding: बहुत पॉज़िटिव का मतलब long भीड़ में हैं |
| नीचे | ऊपर | short बन रहे हैं, या long गिरावट में ख़रीद रहे हैं | Funding: बहुत नेगेटिव का मतलब short squeeze का जोखिम |
| ऊपर | नीचे | तेज़ी short कवर होने से चल रही है, नया पैसा नहीं | क्या OI हर एक्सचेंज पर गिर रहा है |
| नीचे | नीचे | long बंद हो रहे हैं, अपनी मर्ज़ी से या ज़बरदस्ती | 5 मिनट में OI का ढहना liquidation की ओर इशारा करता है |
दस्तावेज़ के उदाहरण में GRAM का कुल OI एक घंटे में 0.32% बढ़ा जबकि कीमत 0.19% गिरी, जो औपचारिक रूप से इसे दूसरी पंक्ति में रखता है। पर प्रति घंटे प्रतिशत का अंश सामान्य शोर है: परिदृश्य साफ़ चालों पर और बड़े OI वाले कॉइनों पर पढ़ें।
OI और funding: पोज़िशन कौन रखता है और उसकी क़ीमत कौन चुकाता है
Funding rate दिखाता है कि perpetual futures में कौन-सा पक्ष दूसरे को भुगतान करता है, और OI दिखाता है कि कितनी पोज़िशनें खुली हैं। साथ मिलकर वे बताते हैं कि बाज़ार किस ओर झुका है और कितना leverage वाला है।
OI और कीमत का बढ़ना, साथ में बहुत पॉज़िटिव rate, यानी long पोज़िशन बढ़ा रहे हैं और उन्हें रखने के लिए short को भुगतान कर रहे हैं। कीमत पलटे तो उनके liquidation गिरावट तेज़ कर देते हैं। OI और कीमत का बढ़ना, साथ में नेगेटिव rate, यानी short चाल के ख़िलाफ़ पोज़िशन बना रहे हैं, और तेज़ उछाल उन्हें ज़बरदस्ती बंद करा सकता है।
Funding, OI और कीमत के हर मेल का ब्योरा बाज़ार संकेतक के रूप में funding rate में है। Genesis API में /funding/rates हर एक्सचेंज का rate लौटाता है, वह भी सभी प्लान पर: हर funding अंतराल का rate (funding_pct) और 8 घंटे पर सामान्यीकृत rate (funding_8h_pct)। Funding endpoint और चुकाए गए funding का इतिहास Funding rate API में है, और फ़ील्ड दस्तावेज़ में।
Python: एक घंटे में OI 5% से ज़्यादा बढ़ा और कीमत भी बढ़ी
स्क्रिप्ट पूरा स्नैपशॉट एक कॉल में खींचती है और वे कॉइन रखती है जिनका कुल OI एक घंटे में 5% से ज़्यादा बढ़ा और कीमत ऊपर गई, जबकि OI ख़ुद $5M या उससे अधिक है। हर कॉइन के लिए वह एक्सचेंज-वार ब्योरा छापती है: एक्सचेंज का OI में हिस्सा और उस घंटे में उसके OI और कीमत का बदलाव। कुंजी GENESIS_API_KEY एनवायरनमेंट वेरिएबल से आती है; 429 और 503 पर स्क्रिप्ट Retry-After सेकंड रुकती है और दोबारा कोशिश करती है।
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 # छोटे OI पर एक पोज़िशन उसे बहुत हिला देती है
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 या डेटा का पुनर्निर्माण
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()["data"]
def passes(t):
oi, px = t.get("oi_change_1h"), t.get("price_change_1h")
if oi is None or px is None:
return False
return (t.get("oi_usd") or 0) >= MIN_OI_USD and oi > 5 and px > 0
def pct(v):
return "n/a" if v is None else f"{v:+.1f}%"
hits = [r for r in get("/market/open-interest") if passes(r["total"])]
for row in hits:
t = row["total"]
print(f"{row['coin']}: OI {pct(t['oi_change_1h'])} in 1h, "
f"price {pct(t['price_change_1h'])}, "
f"total ${t['oi_usd'] / 1e6:.1f}M")
exs = sorted(row["exchanges"].items(), reverse=True,
key=lambda kv: kv[1].get("oi_usd") or 0)
for name, m in exs:
share = (m.get("oi_usd") or 0) / t["oi_usd"] * 100
print(f" {name:<8} share {share:4.1f}%, "
f"OI {pct(m.get('oi_change_1h'))}, "
f"price {pct(m.get('price_change_1h'))}")
कॉइन XYZ के लिए उदाहरण आउटपुट (काल्पनिक): एक घंटे में OI +6.2%, कीमत +3.0%, कुल OI $48.1M।
| एक्सचेंज | OI में हिस्सा | OI 1 घंटा | कीमत 1 घंटा |
|---|---|---|---|
| Binance | 46.2% | +8.0% | +3.0% |
| ByBit | 27.0% | +5.0% | +3.1% |
| OKX | 17.5% | +2.0% | +2.9% |
| Bitget | 9.3% | +9.0% | +3.2% |
बढ़त व्यापक है: OI चारों एक्सचेंजों पर बढ़ा, और उनमें से तीन पर 5% या अधिक। अगर यही +6.2% किसी एक ऐसे एक्सचेंज से आता जिसके पास घंटे भर पहले कॉइन के OI का 10% था, तो उसका OI 62% बढ़ना पड़ता: 0.10 × 62 = 6.2। किसी एक एक्सचेंज पर उछाल अक्सर एक बड़े खिलाड़ी का संकेत होता है, और उससे बाज़ार के बारे में निष्कर्ष निकालना जल्दबाज़ी है।
दूसरा हिस्सा funding जोड़ता है: सभी कॉइनों के लिए एक /funding/rates कॉल, और मिले हर कॉइन के लिए एक्सचेंजों में सबसे कम और सबसे ज़्यादा 8 घंटे का rate और कितने एक्सचेंजों पर rate पॉज़िटिव है।
# funding rates for every exchange: one call covers all coins
rates = {row["coin"]: row["exchanges"]
for row in get("/funding/rates")}
for row in hits:
fr = sorted((e["funding_8h_pct"], e["exchange"])
for e in rates.get(row["coin"], [])
if e.get("funding_8h_pct") is not None)
if not fr:
print(f"{row['coin']}: no funding rates")
continue
(lo, lo_ex), (hi, hi_ex) = fr[0], fr[-1]
plus = sum(1 for rate, _ in fr if rate > 0)
print(f"{row['coin']}: 8h funding {lo:+.4f}% ({lo_ex}) "
f"to {hi:+.4f}% ({hi_ex}), positive on {plus} of {len(fr)}")
स्क्रिप्ट दो कॉल करती है। हर मिनट में एक बार चलाने पर 30 दिन में 2 × 60 × 24 × 30 = 86,400 कॉल होती हैं, जो Trial प्लान के 500K कोटे के पाँचवें हिस्से से कम है। बिना बदले डेटा पर कोटा ख़र्च किए लूप में पोल करने के लिए ETag और If-None-Match जोड़ें: तरीक़े लिमिट छुए बिना API कैसे पोल करें में हैं, और कोटे व प्रति सेकंड रिक्वेस्ट Genesis API limits गाइड में।
सावधानियाँ: open interest को क्या बिगाड़ता है
- एक्सचेंजों के तरीक़े अलग हैं। Bybit में दो OI फ़ील्ड हैं जो दोगुने से अलग हैं, OKX
oiको उन कॉन्ट्रैक्ट में गिनता है जिनका आकार एक्सचेंज तय करता है, और एक ही कॉइन का टिकर अलग हो सकता है: एक एक्सचेंज पर PEPE, दूसरे पर 1000PEPE। एक्सचेंजों के बीच तुलना के लिए प्रतिशत बदलाव ज़्यादा सुरक्षित हैं: वे इकाइयों पर निर्भर नहीं करते, बशर्ते हर एक्सचेंज एक रीडिंग से अगली तक एक ही तरह गिने। - डॉलर कीमत पर निर्भर है। हर एक्सचेंज का
oi_usdउसका कॉइन में OI गुणा उसकी अपनी कीमत है, इसलिए तेज़ चाल में पोज़िशनें स्थिर रहने पर भी डॉलर OI बदल जाता है। - Liquidation उछाल पैदा करते हैं। Liquidation की कड़ी में एक्सचेंज पोज़िशनें ज़बरदस्ती बंद करते हैं: कीमत के तेज़ चलने के साथ OI कुछ मिनटों में कई प्रतिशत गिर जाता है।
oi_change_5mका ढहना और साथ मेंprice_change_5mका तेज़ होना liquidation की पहचान है। - छोटा OI बड़े प्रतिशत देता है। जिस कॉइन का OI कुछ सौ हज़ार डॉलर है, उस पर एक पोज़िशन उसे दसियों प्रतिशत हिला देती है, और
total.oi_usdपर एक सीमा यह शोर छान देती है। - कुल इस पर निर्भर है कि उसमें कौन-से एक्सचेंज शामिल हैं। अगर किसी कॉइन के futures एक और एक्सचेंज पर आ जाएँ, तो बाक़ी पर कुछ बदले बिना नए एक्सचेंज के कारण कुल OI बढ़ जाता है। कुल की बढ़त को
exchangesब्योरे से मिलाकर जाँचें।
कोड के बिना वही डेटा साइट की OI Tracking टेबल में है; उसके कॉलम, फ़िल्टर और चार्ट गाइड में बताए गए हैं। API प्लान के कोटे और क़ीमतें Genesis API pricing पेज पर हैं।
सवाल और जवाब
Open interest ट्रेडिंग वॉल्यूम से कैसे अलग है?
वॉल्यूम किसी अवधि के सौदों का जोड़ है; open interest वे पोज़िशनें हैं जो अभी खुली हैं। हर सौदा वॉल्यूम में गिना जाता है, पर OI तभी बदलता है जब दोनों पक्ष पोज़िशन खोलें या दोनों बंद करें। ऊँचा वॉल्यूम और स्थिर OI का मतलब है कि पोज़िशनें ज़्यादातर हाथ बदल रही हैं। /market/open-interest रिस्पॉन्स में दोनों संख्याएँ हैं: volume_24h और oi_usd।
Open interest का इतिहास कहाँ से मिलेगा?
Genesis API में इतिहास नहीं है: endpoint मौजूदा स्नैपशॉट और 5, 15, 30 मिनट व 1 घंटे के बदलाव लौटाता है, इसलिए लंबी सीरीज़ रिस्पॉन्स सहेजकर आप ख़ुद बनाते हैं। एक्सचेंज इतिहास अपने API में देते हैं: Binance पिछले एक महीने का, Bybit 5 मिनट से एक दिन तक के क़दमों में, OKX आख़िरी 1,440 रिकॉर्ड। साइट पर OI Tracking में चार्ट बटन साइट के Pro प्लान में OI चार्ट खोलता है।
Genesis API में OI डेटा कितनी बार अपडेट होता है?
ताज़गी API प्लान पर निर्भर है: Trial पर 60 सेकंड, Start पर 30, Pro पर 10 और Max पर 5। स्नैपशॉट बनने का समय meta.updated_at में है, और आपके प्लान की देरी meta.freshness_sec में। उससे तेज़ पोल करने का फ़ायदा नहीं, और If-None-Match के साथ न बदला स्नैपशॉट 304 के रूप में आता है, जो आपके कोटे से नहीं कटता।
कीमत गिरते समय open interest बढ़ने का क्या मतलब है?
आमतौर पर नए short खुल रहे हैं, या कोई चाल के ख़िलाफ़ long ख़रीद रहा है। अगर उसी समय funding नेगेटिव हो जाए, तो short अपनी पोज़िशन रखने के लिए long को भी भुगतान कर रहे हैं। उस समय ऊपर की ओर तेज़ पलटाव short को ज़बरदस्ती बंद करा सकता है और उछाल को तेज़ कर सकता है।