Genesis Arbitrage

Genesis Arbitrage · · 13 دقیقه مطالعه

API اوپن اینترست: OI فیوچرز در صرافی‌ها و روش خواندن آن

به طور خلاصه

  • اوپن اینترست حجم پوزیشن‌های فیوچرز است که هنوز باز مانده‌اند. اگر به کوین شمرده شود، ورود پوزیشن‌ها را نشان می‌دهد؛ اگر به دلار شمرده شود، با قیمت هم تغییر می‌کند.
  • هر صرافی OI را با قالب و واحد خودش منتشر می‌کند. در Genesis API یک فراخوانی /market/open-interest بیش از 13 صرافی را پوشش می‌دهد: مجموع در total، تفکیک در exchanges، و تغییر OI و قیمت در 5، 15 و 30 دقیقه و 1 ساعت، در همه پلن‌ها.
  • اوپن اینترست در کنار قیمت و فاندینگ نشان می‌دهد چه کسی پوزیشن می‌سازد و چه کسی برای نگه‌داشتن آن می‌پردازد. قیمت را پیش‌بینی نمی‌کند؛ تصمیم و معامله در صرافی با شماست.

API اوپن اینترست برای هر کوین حجم پوزیشن‌های باز فیوچرز را برمی‌گرداند، به کوین و به دلار، برای هر صرافی و در مجموع، همراه با تغییر آن در چند دقیقه و ساعت اخیر. صرافی‌ها OI قراردادهای خود را از طریق API خودشان منتشر می‌کنند و قالب‌ها از صرافی‌ای به صرافی دیگر فرق دارد. در Genesis API کل اسنپ‌شات با یک فراخوانی /market/open-interest می‌آید: بیش از 13 صرافی فیوچرز، از جمله Binance، Bybit، OKX، Bitget و Gate، با تغییر OI و قیمت در 5، 15 و 30 دقیقه و 1 ساعت، در همه پلن‌ها، از Trial با ماهی $20.

اوپن اینترست چیست

اوپن اینترست (OI) مجموع پوزیشن‌های یک قرارداد فیوچرز است که باز شده‌اند و هنوز بسته نشده‌اند. هر قرارداد دو طرف دارد، لانگ و شورت، و OI فقط یکی از آن‌ها را می‌شمارد: یک معامله‌گر 1 BTC لانگ می‌خرد، دیگری 1 BTC شورت می‌فروشد و اوپن اینترست به اندازه 1 BTC بالا می‌رود.

OI وقتی بالا می‌رود که هر دو طرف معامله پوزیشن باز کنند، وقتی پایین می‌آید که هر دو ببندند، و وقتی ثابت می‌ماند که پوزیشن از معامله‌گری به دیگری منتقل شود. پس بالا رفتن OI یعنی پوزیشن‌های تازه وارد می‌شوند و پایین آمدنش یعنی پوزیشن‌ها بسته می‌شوند، با اختیار یا به زور.

OI به کوین و به دلار

صرافی‌ها OI را به قرارداد، به کوین یا مستقیم به دلار گزارش می‌کنند و کوین با قیمت به دلار تبدیل می‌شود. در نمونه پاسخ Genesis API مقدار oi_usd برای GRAM در ByBit برابر است با oi_tokens ضربدر price: 16,159,003.8 × 1.6609 = 26,838,489.41.

رقم دلاری برای مقایسه کوین‌ها و صرافی‌ها راحت است، اما با قیمت جابه‌جا می‌شود. مثال توضیحی: صرافی‌ای 2,000,000 کوین در پوزیشن‌های باز دارد و قیمت $1.50 است، پس OI برابر 2,000,000 × $1.50 = $3,000,000 است. یک ساعت بعد پوزیشن‌ها همان‌اند، قیمت $1.65 است و OI دلاری 2,000,000 × $1.65 = $3,300,000 می‌شود، یعنی 10% بیشتر بدون حتی یک پوزیشن تازه.

OI کل و تفکیک به تفکیک صرافی

OI کل یک کوین، اوپن اینترست صرافی‌هایی را که فیوچرز آن را فهرست کرده‌اند جمع می‌زند و نشان می‌دهد بازار چقدر پول در پوزیشن‌ها دارد. تفکیک نشان می‌دهد این پول کجاست: در همان پاسخ، ByBit سهم 26,838,489.41 / 96,544,685.3 × 100 = 27.8% از OI دلاری GRAM را دارد.

معیارچه نشان می‌دهدنکته
OI به کوینچند پوزیشن باز استاندازه قراردادها در صرافی‌ها فرق دارد
OI به دلارچقدر پول در پوزیشن‌هاستبا قیمت جابه‌جا می‌شود
OI کلپوزیشن‌ها در کل بازاربه صرافی‌های جمع‌شده بستگی دارد
OI هر صرافیپوزیشن‌ها کجا ساخته می‌شوندروش صرافی‌ها فرق دارد

API صرافی‌های Binance، Bybit، OKX و Hyperliquid چه برمی‌گرداند

هر صرافی OI قراردادهایش را از طریق API خودش منتشر می‌کند. مستندات رسمی این را می‌گویند:

صرافیOI فعلیتاریخچه OIحواستان به این باشد
BinanceGET /fapi/v1/openInterest، یک symbol در هر درخواستGET /futures/data/openInterestHistتاریخچه فقط یک ماه اخیر را دربرمی‌گیرد
BybitGET /v5/market/tickers، همه نمادها در یک درخواستGET /v5/market/open-interest، گام از 5min تا 1dopenInterest هر دو طرف را می‌شمارد، singleOpenInterest یک طرف را
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi به قرارداد، oiCcy به کوین، oiUsd به دلار
HyperliquidPOST /info، نوع metaAndAssetCtxsدر مستندات نیستOI فیوچرز بی‌انقضا در یک درخواست

جزئیات در مستندات Binance، Bybit، OKX و Hyperliquid آمده است. تاریخچه Binance با sumOpenInterest و sumOpenInterestValue می‌آید، در حالی که OKX آخرین 1,440 رکورد را با گام‌هایی از 5 دقیقه برمی‌گرداند. Hyperliquid درخواستی به https://api.hyperliquid.xyz/info با بدنه {"type": "metaAndAssetCtxs"} می‌گیرد و برای هر قرارداد بی‌انقضا openInterest را کنار markPx و funding برمی‌گرداند.

تفاوت روش می‌تواند دوبرابر باشد. در نمونه پاسخ /v5/market/open-interest در Bybit مقدار openInterest برابر 63,910,691 و singleOpenInterest برابر 31,955,346 است، دقیقاً نصف: اولی هر دو طرف را می‌شمارد، دومی یک طرف را، مثل تعریف OI در بالا.

ساختن یک اسنپ‌شات به‌تنهایی یعنی پرسش از هر صرافی با قواعد خودش، تبدیل قرارداد به کوین و کوین به دلار، و ماندن در محدودیت‌های هر صرافی. در Binance این کار به یک درخواست جداگانه برای هر قرارداد نیاز دارد.

اوپن اینترست در Genesis API: /market/open-interest

endpoint ‏/market/open-interest همان داده‌های جدول 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_tokensOI کل به دلار و به کوین
total.avg_priceمیانگین قیمت کوین در صرافی‌ها
total.volume_24hحجم 24 ساعته، دلار
total.oi_change_5m/15m/30m/1hتغییر OI در 5، 15 و 30 دقیقه و 1 ساعت، %
total.price_change_5m/15m/30m/1hتغییر قیمت در همان بازه‌ها، %
exchanges{}همین معیارها برای هر صرافی: price به‌جای avg_price، به‌علاوه trade_url

تغییرها درصدند: 0.3185 یعنی 0.3185%. مقدارهای خالی به‌صورت null می‌رسند، پس از آن‌ها بگذرید. تازگی به پلن بستگی دارد: 60 ثانیه در Trial، 30 ثانیه در Start، 10 ثانیه در Pro و 5 ثانیه در Max، بنابراین پرسش بیشتر از meta.freshness_sec فایده‌ای ندارد.

پاسخ بدون فیلتر هدر ETag دارد. آن را در If-None-Match پس بفرستید تا اسنپ‌شات بدون تغییر با 304 برگردد، که از سهمیه شما کم نمی‌کند؛ سازوکار در ETag و If-None-Match توضیح داده شده است. فیلتر exchange فقط exchanges را محدود می‌کند: total همچنان روی همه صرافی‌ها حساب می‌شود.

فیلدها، پارامترها و فرم «امتحان درخواست» در بخش "OI Tracking" مستندات است. همه endpointهای بازار با مثال در راهنمای داده‌های بازار Genesis API مرور شده‌اند.

خواندن OI همراه قیمت: چهار سناریو

بالا رفتن OI می‌گوید پوزیشن‌ها باز می‌شوند، اما نمی‌گوید کدام طرف پیش می‌راند. قیمت در همان بازه سرنخ می‌دهد.

قیمتOIبرداشت معمولچه چیزی را بررسی کنیم
بالابالاپوزیشن‌های تازه در جهت حرکت، صعود پول پشتش استفاندینگ: خیلی مثبت یعنی لانگ‌ها شلوغ‌اند
پایینبالاشورت‌ها در حال ساخته شدن‌اند یا لانگ‌ها در ریزش می‌خرندفاندینگ: خیلی منفی یعنی خطر شورت اسکوییز
بالاپایینصعود با بستن شورت‌ها پیش می‌رود، پول تازه‌ای نیستآیا OI در همه صرافی‌ها پایین می‌آید
پایینپایینلانگ‌ها بسته می‌شوند، با اختیار یا به زورفروریختن OI در 5 دقیقه به لیکوییدیشن اشاره دارد

در مثال مستندات، OI کل GRAM در یک ساعت 0.32% بالا رفت در حالی که قیمت 0.19% افت کرد، که از نظر صوری آن را در ردیف دوم می‌گذارد. اما کسری از درصد در ساعت نویز عادی است: سناریوها را در حرکت‌های روشن و روی کوین‌هایی با OI بزرگ بخوانید.

OI و فاندینگ: چه کسی پوزیشن نگه می‌دارد و چه کسی هزینه‌اش را می‌دهد

نرخ فاندینگ نشان می‌دهد کدام طرف فیوچرز بی‌انقضا به دیگری می‌پردازد و OI نشان می‌دهد چند پوزیشن باز است. با هم نشان می‌دهند بازار به کدام سو متمایل است و چقدر اهرمی است.

بالا رفتن OI و قیمت با نرخ خیلی مثبت یعنی لانگ‌ها پوزیشن اضافه می‌کنند و برای نگه‌داشتنش به شورت‌ها می‌پردازند. اگر قیمت برگردد، لیکوییدیشن آن‌ها ریزش را تندتر می‌کند. بالا رفتن OI و قیمت با نرخ منفی یعنی شورت‌ها خلاف حرکت پوزیشن می‌سازند و صعود تند می‌تواند آن‌ها را به زور ببندد.

همه ترکیب‌های فاندینگ، OI و قیمت در نرخ فاندینگ به‌عنوان نشانگر بازار آمده است. در Genesis API، /funding/rates نرخ همه صرافی‌ها را برمی‌گرداند، آن هم در همه پلن‌ها: نرخ هر بازه فاندینگ (funding_pct) و نرخ نرمال‌شده به 8 ساعت (funding_8h_pct). endpointهای فاندینگ و تاریخچه فاندینگ اجراشده در 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):  # محدودیت نرخ یا بازسازی داده‌ها
            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.

صرافیسهم OIOI در 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% از یک صرافی می‌آمد که یک ساعت پیش 10% از OI کوین را داشت، OI آن باید 62% رشد می‌کرد: 0.10 × 62 = 6.2. جهش در یک صرافی بیشتر به یک بازیگر بزرگ اشاره دارد و برای نتیجه‌گیری درباره بازار از روی آن زود است.

بخش دوم فاندینگ را اضافه می‌کند: یک فراخوانی /funding/rates برای همه کوین‌ها و برای هر کوین پیداشده، کمترین و بیشترین نرخ 8 ساعته در صرافی‌ها و تعداد صرافی‌هایی که نرخ مثبت دارند.

# 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 فراخوانی می‌شود، یعنی کمتر از یک‌پنجم سهمیه 500K پلن Trial. برای پرسش حلقه‌ای بدون خرج کردن سهمیه روی داده بدون تغییر، ETag و If-None-Match را اضافه کنید: روش‌ها در چگونه API را بدون برخورد با محدودیت‌ها پرسش کنیم آمده و سهمیه‌ها و درخواست در ثانیه در راهنمای محدودیت‌های Genesis API.

نکات احتیاط: چه چیزی اوپن اینترست را منحرف می‌کند

بدون کد، همین داده‌ها در جدول OI Tracking در سایت هست؛ ستون‌ها، فیلترها و نمودارهایش در راهنما شرح داده شده است. سهمیه و قیمت پلن‌های API در صفحه قیمت Genesis API است.

پرسش و پاسخ

اوپن اینترست با حجم معاملات چه فرقی دارد؟

حجم مجموع معاملات در یک بازه است؛ اوپن اینترست پوزیشن‌هایی است که همین حالا باز مانده‌اند. هر معامله در حجم حساب می‌شود، اما OI را فقط وقتی تغییر می‌دهد که هر دو طرف پوزیشن باز کنند یا هر دو ببندند. حجم بالا با OI ثابت یعنی پوزیشن‌ها بیشتر دست‌به‌دست می‌شوند. پاسخ /market/open-interest هر دو عدد را دارد: volume_24h و oi_usd.

تاریخچه اوپن اینترست را از کجا بگیرم؟

Genesis API تاریخچه ندارد: endpoint اسنپ‌شات فعلی و تغییرها در 5، 15 و 30 دقیقه و 1 ساعت را برمی‌گرداند، پس سری بلند را با ذخیره پاسخ‌ها خودتان می‌سازید. صرافی‌ها تاریخچه را در API خودشان می‌دهند: Binance برای یک ماه اخیر، Bybit با گام از 5 دقیقه تا یک روز، OKX آخرین 1,440 رکورد. در سایت، دکمه نمودار در OI Tracking نمودار OI را در پلن Pro سایت باز می‌کند.

داده OI در Genesis API هر چند وقت یک‌بار به‌روز می‌شود؟

تازگی به پلن API بستگی دارد: 60 ثانیه در Trial، 30 در Start، 10 در Pro و 5 در Max. زمان ساخت اسنپ‌شات در meta.updated_at است و تأخیر پلن شما در meta.freshness_sec. پرسش سریع‌تر از آن فایده ندارد، و با If-None-Match اسنپ‌شات بدون تغییر با 304 برمی‌گردد که از سهمیه شما کم نمی‌کند.

بالا رفتن اوپن اینترست با افت قیمت یعنی چه؟

معمولاً شورت‌های تازه باز می‌شوند یا کسی خلاف حرکت لانگ می‌خرد. اگر هم‌زمان فاندینگ منفی شود، شورت‌ها برای نگه‌داشتن پوزیشن‌هایشان به لانگ‌ها هم می‌پردازند. برگشت تند به بالا در آن لحظه می‌تواند شورت‌ها را به بستن مجبور کند و صعود را سریع‌تر کند.