Genesis Arbitrage

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

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 से छापता है। आधिकारिक दस्तावेज़ यह कहते हैं:

एक्सचेंजमौजूदा OIOI का इतिहासध्यान दें
BinanceGET /fapi/v1/openInterest, हर रिक्वेस्ट में एक symbolGET /futures/data/openInterestHistइतिहास केवल पिछले एक महीने का है
BybitGET /v5/market/tickers, सारे symbol एक रिक्वेस्ट मेंGET /v5/market/open-interest, 5min से 1d तक के क़दमopenInterest दोनों पक्ष गिनता है, singleOpenInterest एक पक्ष
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi कॉन्ट्रैक्ट में, oiCcy कॉइन में, oiUsd डॉलर में
HyperliquidPOST /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_24h24 घंटे का वॉल्यूम, USD
total.oi_change_5m/15m/30m/1h5, 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 घंटा
Binance46.2%+8.0%+3.0%
ByBit27.0%+5.0%+3.1%
OKX17.5%+2.0%+2.9%
Bitget9.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 को क्या बिगाड़ता है

कोड के बिना वही डेटा साइट की 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 को ज़बरदस्ती बंद करा सकता है और उछाल को तेज़ कर सकता है।