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 | حواستان به این باشد |
|---|---|---|---|
| Binance | GET /fapi/v1/openInterest، یک symbol در هر درخواست | GET /futures/data/openInterestHist | تاریخچه فقط یک ماه اخیر را دربرمیگیرد |
| Bybit | GET /v5/market/tickers، همه نمادها در یک درخواست | 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 | در مستندات نیست | 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_tokens | OI کل به دلار و به کوین |
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.
| صرافی | سهم 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% از یک صرافی میآمد که یک ساعت پیش 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.
نکات احتیاط: چه چیزی اوپن اینترست را منحرف میکند
- روش صرافیها فرق دارد. Bybit دو فیلد OI دارد که دو برابر فرق میکنند، OKX مقدار
oiرا به قراردادهایی میشمارد که اندازهشان را خود صرافی تعیین میکند، و نماد یک کوین هم میتواند فرق کند: PEPE در یک صرافی و 1000PEPE در دیگری. مقایسه با تغییر درصدی بین صرافیها امنتر است: تا وقتی هر صرافی از یک قرائت تا قرائت بعد به یک روش میشمارد، به واحد وابسته نیست. - دلار به قیمت بستگی دارد.
oi_usdهر صرافی برابر OI آن به کوین ضربدر قیمت خودش است، پس در حرکت تند OI دلاری حتی با ثابت ماندن پوزیشنها تغییر میکند. - لیکوییدیشنها جهش میسازند. در زنجیره لیکوییدیشن، صرافیها پوزیشنها را به زور میبندند: OI طی چند دقیقه چند درصد افت میکند و قیمت شدید حرکت میکند. فروریختن
oi_change_5mهمراه باprice_change_5mتند، نشانه لیکوییدیشنهاست. - OI کوچک درصدهای بزرگ میسازد. در کوینی با چند صد هزار دلار OI، یک پوزیشن آن را دهها درصد جابهجا میکند و آستانهای روی
total.oi_usdاین نویز را حذف میکند. - مجموع به صرافیهایی که شامل میشود بستگی دارد. اگر کوینی در یک صرافی دیگر فیوچرز بگیرد، OI کل بهخاطر جایگاه تازه رشد میکند در حالی که در بقیه چیزی تغییر نکرده است. رشد مجموع را با تفکیک
exchangesبسنجید.
بدون کد، همین دادهها در جدول 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 برمیگردد که از سهمیه شما کم نمیکند.
بالا رفتن اوپن اینترست با افت قیمت یعنی چه؟
معمولاً شورتهای تازه باز میشوند یا کسی خلاف حرکت لانگ میخرد. اگر همزمان فاندینگ منفی شود، شورتها برای نگهداشتن پوزیشنهایشان به لانگها هم میپردازند. برگشت تند به بالا در آن لحظه میتواند شورتها را به بستن مجبور کند و صعود را سریعتر کند.