Genesis Arbitrage

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

نقاط نهاية التمويل في Genesis API: المعدلات والفرق وتحليلات سجل التمويل

باختصار

  • /funding/rates و/funding/spread متاحتان في كل خطط API: معدل كل منصة لكل فترة ولكل 8 ساعات، ووقت الدفعة القادمة، وأفضل زوج منصات حسب الفرق.
  • تحليلات التمويل المسوّى هي أربع نقاط نهاية /funding/analytics/… عبر 13 منصة مع سجل يصل إلى سنة، في خطتي Pro وMax.
  • التنزيلات الكاملة لـ summary وrecent وdaily يصل وزنها إلى نحو 12 MB بعد ضغط gzip وتُسمح مرة كل 60–300 ثانية: خذ شريحة coin أو كرّر الطلب مع If-None-Match.

واجهة معدلات التمويل في Genesis API هي مجموعة نقاط نهاية تقدّم معدلات التمويل للعقود الدائمة عبر المنصات، وأفضل زوج منصات حسب فرق التمويل، وسجل التمويل المسوّى. المعدلات الحالية والفرق متاحة في كل خطط API؛ أما التحليلات التاريخية لـ 13 منصة ففي Pro وMax. يعرض الموقع البيانات نفسها في Funding Arbitrage، راجع الدليل.

نقاط نهاية التمويل والخطط

نقطة النهايةما تعيدهخطط API
/funding/ratesمعدلات كل منصة لكل عملةTrial وStart وPro وMax
/funding/spreadأفضل زوج منصات حسب الفرق وبقية المنصاتTrial وStart وPro وMax
/funding/analytics/summaryملخص لفترات من يوم إلى سنةPro وMax
/funding/analytics/recentكل دفعة خلال 7 أيامPro وMax
/funding/analytics/dailyمجاميع يومية خلال 365 يوماًPro وMax
/funding/analytics/topسكرينر الأزواج وحزم المنصاتPro وMax

المعاملات والحقول في أقسام التوثيق معدلات التمويل وفرق التمويل والتحليلات. في Trial وStart تعيد نقاط نهاية التحليلات 403 plan_restricted. للاطلاع على نظرة عامة على واجهات بيانات التمويل، راجع مقال API معدل التمويل. أمثلة الاستجابة أدناه تعرض الحقل data مختصراً.

المعدلات والتطبيع إلى 8 ساعات

تعيد /funding/rates لكل عملة قائمة بالمنصات مع المعدل الحالي. المرشحان coin وexchange (مفصولان بفواصل لعدة منصات) اختياريان.

curl "https://api.genesisarbitrage.com/v1/funding/rates?coin=TON" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}
الحقلالمعنى
funding_pctالمعدل لكل فترة تسوية، %
funding_8h_pctالمعدل مطبّعاً إلى 8 ساعات، %
intervalفترة التسوية، مثل 8h؛ null — لا بيانات
next_payoutوقت الدفعة القادمة، HH:MM بتوقيت UTC؛ null — لا بيانات
price، trade_urlالسعر ورابط منصة التداول في المنصة

مثال افتراضي: معدل ساعي قدره 0.005% يساوي 0.005 × 8 / 1 = 0.04% لكل 8 ساعات، أي مثل MEXC، غير أنه يُدفع ثماني مرات وقد يتغير بحلول الساعة التالية.

بالتحويل السنوي دون رسملة، يعطي معدل 8 ساعات × 3 × 365 قيمة APR. مثال افتراضي: 0.01% كل 8 ساعات تعطي 0.01 × 3 × 365 = 10.95% في السنة، ما دام المعدل ثابتاً. وما يقوله المعدل عن السوق مشروح في معدل التمويل كمؤشر للسوق.

فرق التمويل: أفضل زوج منصات

تعيد /funding/spread لكل عملة أفضل زوج منصات حسب فرق التمويل (best) وبقية المنصات (others). المرشحان: coin وmin_spread، وهو الحد الأدنى للفرق بـ %.

{
  "coin": "BTC",
  "spread_pct": 0.01,
  "best": {
    "exchange_1": "Hyper",
    "exchange_2": "CoinEx",
    "funding_1_pct": 0.0,
    "funding_2_pct": 0.0,
    "next_payout_1": null,
    "next_payout_2": "08:00",
    "interval_1": "1h",
    "interval_2": "8h",
    "trade_url_1": "https://app.hyperliquid.xyz/trade/BTC",
    "trade_url_2": "https://www.coinex.com/futures/BTC-usdt"
  },
  "others": [ … ]
}

spread_pct هو فرق أفضل زوج، %. أما funding_1_pct وfunding_2_pct فهما المعدلان لكل فترة خاصة بكل منهما (interval_1 وinterval_2): للمقارنة يدوياً طبّع كليهما إلى 8 ساعات. يُفتح البيع على المكشوف (short) حيث المعدل أعلى، والشراء (long) حيث هو أدنى. تظهر Hyperliquid في الاستجابات باسم Hyper.

يطبع سكربت Python عشر عملات بأعلى spread_pct (من 0.05%) مع فترات تسوية الزوج. عند 429 و503 ينتظر Retry-After ثانية؛ وفي الحلقة كرّر الطلب بما لا يزيد عن مرة كل meta.freshness_sec.

import os
import time
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

for _ in range(3):
    r = requests.get(URL, headers=HEADERS,
                     params={"min_spread": 0.05}, timeout=15)
    if r.status_code not in (429, 503):
        break
    # تجاوز الحد أو إعادة بناء البيانات: انتظر ثم أعد المحاولة
    time.sleep(int(r.headers.get("Retry-After", "5")))
r.raise_for_status()

rows = sorted(r.json()["data"], key=lambda x: x["spread_pct"],
              reverse=True)
for row in rows[:10]:
    b = row["best"]
    print(f'{row["coin"]:<10} {row["spread_pct"]:>8.4f}%  '
          f'{b["exchange_1"]} {b["interval_1"]} / '
          f'{b["exchange_2"]} {b["interval_2"]}')

تحليلات التمويل المسوّى

تعيد أربع نقاط نهاية /funding/analytics/… سجل التمويل المسوّى عبر 13 منصة، وهي البيانات نفسها الموجودة في تبويب التحليلات داخل Funding Arbitrage. المعدلات نسبة مئوية لكل فترة تسوية، والطوابع الزمنية بثواني epoch بتوقيت UTC.

نقطة النهايةالمحتوىالقسم الكاملبدون coin بحد أقصى
/funding/analytics/summaryالمجاميع ومتوسط المعدلات وAPR والتغطية لـ 7 فترات~600 KB gzipمرة كل 60 ث
/funding/analytics/recentكل دفعة خلال 7 أيام~1 MB gzipمرة كل 60 ث
/funding/analytics/dailyمجاميع يومية خلال 365 يوماًحتى ~12 MB gzipمرة كل 300 ث
/funding/analytics/topأفضل 50 زوجاً وأفضل 50 حزمة لكل فترة—بلا حد

التنزيل الكامل قبل انتهاء النافذة يعيد 429 مع Retry-After. قواعد ETag والضغط مشروحة في دليل صيغة الاستجابة والأخطاء.

curl --compressed -i \
  "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -H "If-None-Match: <ETag from the previous response>"

يطلب --compressed استجابة مضغوطة ويفك ضغطها، ويطبع -i الترويسات ومنها ETag. أرسل الطلب الأول بدون If-None-Match.

الملخص والمصفوفة m

لكل زوج عملة×منصة في الملخص حقل m: المفتاح فترة (1d و3d و7d و30d و90d و180d و365d)، والقيمة 14 رقماً بترتيب metric_order. تغيب الفترة من m عندما لا توجد لها بيانات إطلاقاً.

{
  "metric_order": ["sum", "avg8h", "apr", "n", "pos", "neg", "zero",
                   "min", "max", "cov", "med8h", "pos_streak",
                   "neg_streak", "flips"],
  "coins": {
    "BTC": {
      "canon": "BTC",
      "mult": 1,
      "exchanges": {
        "Binance": {
          "interval_h": 8.0,
          "data_since": 1568102400,
          "last8h": 0.004123,
          "m": {
            "7d": [0.12802, 0.006298, 6.896, 21, 21, 0, 0,
                   0.000125, 0.01, 1.0, 0.00588, 7, 0, 0]
          }
        }
      }
    }
  }
}
المقياسالفهرسالمعنى
sum0المتراكم خلال الفترة، %
avg8h1متوسط المعدل بمعيار 8 ساعات، %
apr2القيمة السنوية، %
n3عدد التسويات
pos، neg، zero4–6التسويات الموجبة والسالبة والصفرية
min، max7–8أصغر تسوية وأكبرها، %
cov9تغطية الفترة من 0 إلى 1
med8h10الوسيط بمعيار 8 ساعات، %
pos_streak، neg_streak11–12أيام متتالية موجبة وسالبة
flips13تغيّرات الإشارة

الفهارس 10–13 تكون null للفترتين 1d و3d. عندما تكون cov < 0.9 فالبيانات تغطي جزءاً من الفترة فقط، فأشِر إلى هذه القيم. في المثال: BTC على Binance خلال 7 أيام: 21 تسوية كلها موجبة، وcov تساوي 1.0، وapr تساوي avg8h × 3 × 365: 0.006298 × 1095 ≈ 6.896.

إذا كانت avg8h أعلى بكثير من med8h فقد رفع المتوسطَ ارتفاعٌ حاد: الوسيط وpos_streak وflips تبيّن الاستقرار بصورة أفضل. بقية حقول الزوج:

الدفعات خلال 7 أيام والمجاميع اليومية

في /funding/analytics/recent لكل منصة سلسلة s بالشكل ts:rate;ts:rate;… بترتيب زمني تصاعدي وفترة i بالساعات. وفي /funding/analytics/daily تحمل السلسلة day_ts:sum:pos:neg;… منتصف ليل UTC ومجموع اليوم وعدد التسويات الموجبة والسالبة.

def parse_recent(s):
    # "ts:rate;ts:rate;…" → [(ts, rate), …]
    return [(int(t), float(v)) for t, v in
            (p.split(":") for p in s.split(";") if p)]


def parse_daily(s):
    # "day_ts:sum:pos:neg;…" → [(day, sum, positive, negative), …]
    out = []
    for p in filter(None, s.split(";")):
        d, total, pos, neg = p.split(":")
        out.append((int(d), float(total), int(pos), int(neg)))
    return out

سكرينر الحزم

/funding/analytics/top سكرينر جاهز بلا معاملات: لكل فترة أفضل 50 زوج عملة×منصة حسب التمويل المتراكم وأفضل 50 حزمة short/long. ساقا الحزمة دائماً على منصتين مختلفتين بتغطية لا تقل عن 0.9، ولا تظهر أبداً الصفوف التي net فيها ≤ 0.

حقل الحزمةالمعنى
gross، fees، netالتمويل الإجمالي، ورسوم أربع صفقات حسب taker_fees، وnet = gross − fees
apr_net، apr_capitalالقيمة السنوية على حجم ساق واحدة، وapr_net / 2 على رأس مال الساقين
win_rate، max_ddحصة الأيام الرابحة (0..1) وأقصى تراجع للنتيجة التراكمية
worst_streak، risk_daysأطول سلسلة أيام خاسرة وعدد الأيام التي قيس عليها الخطر، بحد أقصى 90
live_8h، trend_1d، trend_7dفرق المعدل الحالي لكل 8 ساعات والفرق الإجمالي خلال آخر يوم وأسبوع
price_divفجوة السعر الحالية بين الساقين؛ null عند عدم توفر الأسعار
short_sym، long_symرمزا الساقين الفعليان في المنصتين، وقد يختلفان: PEPE و1000PEPE

في مثال التوثيق حققت حزمة PEPE — short على HTX وlong على Hyperliquid — قيمة gross قدرها 1.51504% خلال 7 أيام. الرسوم 0.05% للفتح و0.05% للإغلاق على HTX، و0.045% لكل منهما على Hyperliquid: 0.05 × 2 + 0.045 × 2 = 0.19.

إذن net = 1.51504 − 0.19 = 1.32504%، وapr_net = 1.32504 × 365 / 7 ≈ 69.09%، وapr_capital = 69.09 / 2 ≈ 34.55%. فجوة السعر بين الساقين والانزلاق السعري والهامش غير محسوبة.

كيف تبني مراقب تمويل

  1. ابحث عن المرشحين

    اطلب /funding/spread مع min_spread (في أي خطة API) ورتّب حسب spread_pct.

  2. تحقق من المعدلات والدفعات

    اطلب /funding/rates مع coin: الحقول interval وnext_payout وfunding_8h_pct على المنصتين. يجب أن يكون المركز مفتوحاً وقت التسوية.

  3. انظر إلى السجل

    في Pro وMax اطلب /funding/analytics/summary مع coin: قيم sum وapr وcov وflips لفترتي 7d و30d تبيّن هل الفجوة في المعدلات مستمرة.

  4. قيّم الحزمة كاملة

    في /funding/analytics/top قارن net وapr_capital وwin_rate وmax_dd وprice_div الحالي.

  5. افتح المراكز بنفسك

    تقود روابط trade_url إلى منصات التداول؛ احسب تكلفة الحزمة مع الرسوم في حاسبة الفرق.

أسئلة وأجوبة

كيف أطبّع معدل التمويل إلى 8 ساعات؟

اضرب المعدل لكل فترة في 8 ثم اقسمه على طول الفترة بالساعات. تفعل /funding/rates ذلك عنك في الحقل funding_8h_pct.

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

/funding/analytics/recent فيها كل دفعة خلال 7 أيام، و/funding/analytics/daily مجاميع يومية خلال سنة، و/funding/analytics/summary إجماليات لكل فترة. الثلاث متاحة في خطتي API Pro وMax.

لماذا يعيد قسم التحليلات الكامل 429؟

التنزيلات الكاملة بدون coin محدودة: summary وrecent مرة كل 60 ثانية، وdaily مرة كل 300 ثانية لكل مفتاح. شرائح العملة وردود 304 على If-None-Match بلا حد.