Genesis Arbitrage

Genesis Arbitrage · · 12 دقائق قراءة

API الفائدة المفتوحة: OI العقود الآجلة عبر المنصات وكيف تقرؤه

باختصار

  • الفائدة المفتوحة هي حجم مراكز العقود الآجلة التي لا تزال مفتوحة. وعند حسابها بالعملات تُظهر تدفق المراكز، أما بالدولار فتتحرك مع السعر أيضًا.
  • تنشر كل منصة OI بصيغتها ووحداتها. في Genesis API يغطي استدعاء واحد لـ /market/open-interest أكثر من 13 منصة: المجموع في total والتفصيل في exchanges، مع تغيّر OI والسعر خلال 5 و15 و30 دقيقة وساعة، في كل الخطط.
  • تُظهر الفائدة المفتوحة مع السعر والتمويل من يبني المراكز ومن يدفع ثمن الاحتفاظ بها. وهي لا تتنبأ بالسعر؛ فالقرار والصفقة على المنصة يبقيان لك.

يعيد API الفائدة المفتوحة لكل عملة حجم مراكز العقود الآجلة المفتوحة، بالعملات وبالدولار، لكل منصة وفي المجموع، مع تغيّره خلال الدقائق والساعات الأخيرة. تنشر المنصات OI لعقودها عبر واجهاتها الخاصة، وتختلف الصيغ من منصة إلى أخرى. في Genesis API تأتي اللقطة كاملة من استدعاء واحد لـ /market/open-interest: 13+ منصة عقود آجلة، منها Binance وBybit وOKX وBitget وGate، مع تغيّر OI والسعر خلال 5 و15 و30 دقيقة وساعة، في كل الخطط، بدءًا من 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 لكل منصةأين تُبنى المراكزتختلف طرق المنصات

ما تعيده واجهات 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.

قد يصل الفرق في الطريقة إلى الضعف. في مثال استجابة Bybit لـ /v5/market/open-interest تبلغ openInterest 63,910,691 وsingleOpenInterest 31,955,346، أي النصف تمامًا: الأولى تحسب الطرفين والثانية طرفًا واحدًا، كما في تعريف OI أعلاه.

بناء لقطة واحدة بنفسك يعني استطلاع كل منصة وفق قواعدها، وتحويل العقود إلى عملات والعملات إلى دولارات، والبقاء ضمن حدود كل منصة. وفي Binance يتطلب ذلك طلبًا منفصلًا لكل عقد.

الفائدة المفتوحة في Genesis API: /market/open-interest

تعيد نقطة /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 دقيقة وساعة، %
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" من التوثيق. وتُشرح كل نقاط السوق بالأمثلة في دليل بيانات السوق في 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). نقاط التمويل وسجل التمويل المنفَّذ في 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 خلال ساعةالسعر خلال ساعة
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 ساعات وأعلاه عبر المنصات وعدد المنصات ذات المعدل الإيجابي.

# معدلات التمويل لكل المنصات: استدعاء واحد يغطي كل العملات
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)}")

يجري السكربت استدعاءين. وعند تشغيله مرة كل دقيقة يبلغ ذلك 2 × 60 × 24 × 30 = 86,400 استدعاء في 30 يومًا، أي أقل من خُمس حصة خطة Trial البالغة 500K. وللاستطلاع في حلقة دون إنفاق الحصة على بيانات لم تتغير أضف ETag وIf-None-Match: التقنيات في كيف تستطلع API دون بلوغ الحدود، والحصص والطلبات في الثانية في دليل حدود Genesis API.

تنبيهات: ما يشوّه الفائدة المفتوحة

وبدون كود، البيانات نفسها في جدول OI Tracking على الموقع؛ وأعمدته ومرشحاته ورسومه في الدليل. أما حصص خطط API وأسعارها ففي صفحة أسعار Genesis API.

أسئلة وأجوبة

بماذا تختلف الفائدة المفتوحة عن حجم التداول؟

الحجم هو مجموع الصفقات خلال فترة؛ أما الفائدة المفتوحة فهي المراكز التي تبقى مفتوحة الآن. كل صفقة تُحسب في الحجم، لكنها تغيّر OI فقط عندما يفتح الطرفان مركزين أو يغلقانهما. حجم مرتفع مع OI ثابتة يعني أن المراكز تنتقل غالبًا من يد إلى يد. استجابة /market/open-interest فيها الرقمان: volume_24h وoi_usd.

من أين أحصل على سجل الفائدة المفتوحة؟

لا يوفّر Genesis API سجلًا: النقطة تعيد اللقطة الحالية والتغيّرات خلال 5 و15 و30 دقيقة وساعة، فالسلسلة الطويلة تبنيها بحفظ الاستجابات. وتقدم المنصات السجل في واجهاتها: 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 لا يستهلك حصتك.

ماذا يعني ارتفاع الفائدة المفتوحة مع هبوط السعر؟

عادةً تُفتح شورت جديدة، أو يشتري أحدهم لونج عكس الحركة. وإذا صار التمويل سلبيًا في الوقت نفسه فإن الشورت تدفع أيضًا للونج مقابل الاحتفاظ بمراكزها. وانعكاس حاد للأعلى عندئذ قد يجبر الشورت على الإغلاق ويسرّع الصعود.