API معدل التمويل: معدلات كل المنصات في طلب واحد مع سجل التمويل المنفَّذ
باختصار
- يجب أن يعيد API معدل التمويل لكل منصة المعدل لكل فترة والفترة نفسها ووقت التمويل التالي والمعدل بمقياس 8 ساعات وسعر العقد الآجل.
- لدى Binance وBybit وOKX وHyperliquid نقاط نهاية ووحدات وطرق مختلفة للإبلاغ عن الفترة. أما
/funding/ratesفي Genesis API فيعيد معدلات كل المنصات بطلب GET واحد، بالنسبة المئوية ومطبّعة إلى 8 ساعات. - سجل التمويل المنفَّذ في 13 منصة — المجاميع ومتوسط المعدلات وAPR ومجاميع يومية لسنة كاملة وسكرينر للحزم مع
netبعد الرسوم — موجود في/funding/analytics/*ضمن خطتي Pro وMax.
يعيد API معدل التمويل لـالعقود الآجلة الدائمة معدلات التمويل حسب المنصة: المعدل لكل فترة والفترة نفسها ووقت التمويل التالي، وفي النسخة الأكمل سجل التمويل المنفَّذ. لكل منصة API خاص بها بمساراتها ووحداتها وفتراتها، لذا تجمع المعدلات في جدول واحد وتحوّلها إلى نسبة مئوية وتطبّعها إلى فترة واحدة، عادةً 8 ساعات، لتقارن بينها.
ما الذي يجب أن يعيده API معدل التمويل
المعدل بلا فترته لا يقول شيئاً: 0.02% كل 4 ساعات و0.02% كل 8 ساعات يختلفان بمقدار الضعف. لذلك يعيد API معدلات التمويل للعملات الرقمية المفيد خمس قيم لكل زوج عملة–منصة.
| ما تحتاجه | لماذا | حقل /funding/rates |
|---|---|---|
| المعدل لكل فترة | قيمة الدفعة التالية | funding_pct |
| فترة التمويل | لا يمكن مقارنة المعدلات بدونها | interval |
| وقت التمويل التالي | يجب أن يكون المركز مفتوحاً قبله | next_payout |
| المعدل لكل 8 ساعات | مقارنة المنصات ذات الفترات المختلفة | funding_8h_pct |
| سعر العقد الآجل | فرق السعر بين الساقين يغيّر دخولك | price |
الدفعة تساوي حجم المركز مضروباً في المعدل: مركز بقيمة 10,000 دولار عند 0.01% يستلم أو يدفع دولاراً واحداً في كل تسوية.
لماذا تختلف فترات المنصات وكيف نطبّع المعدل إلى 8 ساعات
تقرر كل منصة عدد مرات تسوية التمويل ويمكنها تغيير الفترة لعقد بعينه. في تحليلات Genesis API فترات المنصات المركزية 8 و4 ساعات، بينما تسوّي Hyperliquid وLighter كل ساعة. تحسب Hyperliquid المعدل كمعدل 8 ساعات وتدفع ثمنه كل ساعة، كما هو موضح في قواعد التمويل في Hyperliquid.
في مثال توثيق Genesis API تفرض MEXC على TON معدل 0.02% كل 4 ساعات: 0.02 × 8 / 4 = 0.04% لكل 8 ساعات. مثال افتراضي بفترة ساعة: المنصة A تدفع 0.004% كل ساعة، والمنصة B تدفع 0.02% كل 8 ساعات. بالأرقام الخام تدفع A خُمس ما تدفعه B، لكن على 8 ساعات يصبح 0.004 × 8 / 1 = 0.032% مقابل 0.02%، أي 1.6 ضعف.
يفترض التطبيع أن المعدل يبقى ثابتاً طوال الفترة، والمعدل الساعي قد يتغير عند التسوية التالية مباشرة. وحده السجل يُظهر ما دُفع فعلاً.
يُحسب APR من معدل 8 ساعات: ثلاث تسويات في اليوم و1,095 في السنة. للمنصة A يكون ذلك 0.032 × 3 × 365 = 35.04% سنوياً، ما دام المعدل ثابتاً.
واجهات API لمعدل التمويل في المنصات: Binance وBybit وOKX وHyperliquid
لكل منصة كبرى API خاص بمعدل التمويل: مسارات وحقول وطريقة للإبلاغ عن الفترة.
| المنصة | المعدل الحالي | السجل | الفترة |
|---|---|---|---|
| Binance | GET /fapi/v1/premiumIndex | GET /fapi/v1/fundingRate | GET /fapi/v1/fundingInfo |
| Bybit | GET /v5/market/tickers | GET /v5/market/funding/history | حقل fundingIntervalHour |
| OKX | GET /api/v5/public/funding-rate | GET /api/v5/public/funding-rate-history | من fundingTime وnextFundingTime |
| Hyperliquid | POST /info, metaAndAssetCtxs | POST /info, fundingHistory | كل ساعة |
يعيد API معدل التمويل في Binance المعدل ووقت التمويل التالي في حقلي lastFundingRate وnextFundingTime ضمن premiumIndex (توثيق Binance)، وتأتي معدلات التمويل التاريخية في Binance من fundingRate الذي يقبل startTime وendTime (سجل معدل التمويل). يعيد fundingInfo الفترة فقط للعقود التي عدّلت المنصة فترتها أو سقف معدلها (وصف نقطة النهاية).
تعيد Bybit الحقول fundingRate وnextFundingTime وfundingIntervalHour في استجابة tickers واحدة مع category=linear (Bybit tickers)، ويشترط طلب السجل لديها symbol (سجل التمويل في Bybit). وكما ينبّه التوثيق، لكل عقد فترته الخاصة.
أما في OKX فيقترح التوثيق استنتاج فترة العقد من الفرق بين nextFundingTime وfundingTime (توثيق OKX).
تستقبل Hyperliquid كل طلبات البيانات عند POST https://api.hyperliquid.xyz/info، وجسم JSON هو الذي يحدد ما يعود: {"type": "metaAndAssetCtxs"} يعيد funding الحالي لكل أصل، و{"type": "fundingHistory", "coin": "ETH", "startTime": …} يعيد سجل المعدلات (توثيق Hyperliquid).
لدمج هذه المنصات في جدول واحد، يجب أن يقوم الكود بما يلي:
- تحويل المعدلات من كسور إلى نسبة مئوية؛
- إيجاد فترة كل عقد وتطبيع المعدل إلى 8 ساعات؛
- تحويل الطوابع الزمنية من الميلي ثانية ومطابقة الرموز:
BTCUSDTوBTC-USDT-SWAPوBTC، إضافة إلى المضاعفات مثل1000PEPEفي العملات الأصغر؛ - احترام حدود الطلبات (rate limits) لكل منصة وتحديث الكود عندما تغيّر المنصة API الخاص بها.
كل المنصات في طلب واحد: /funding/rates
يعيد GET /funding/rates لكل عملة قائمة المنصات مع المعدل الحالي: Binance وOKX وBybit وBitget وMEXC وGate وBingX وHTX وHyperliquid والمنصات الأخرى التي تغطيها Genesis Arbitrage، أكثر من 1000 عملة إجمالاً. المرشحان coin وexchange (مفصولان بفاصلة لعدة منصات) اختياريان؛ وبدونهما تحصل على المجموعة كاملة.
curl --compressed \
"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"
}
]
}
هذا عنصر واحد من مصفوفة data داخل الغلاف الذي تشترك فيه كل استجابات Genesis API: success وdata وmeta. المعدلات بالنسبة المئوية، وnext_payout وقت الدفعة بصيغة HH:MM بتوقيت UTC، والقيم الفارغة null، وتظهر Hyperliquid باسم Hyper. كل الحقول ونموذج «جرّب الطلب» في قسم معدلات التمويل من التوثيق.
/funding/rates و/funding/spread متاحان في كل الخطط، بدءاً من Trial بسعر 20 دولاراً شهرياً: 500 ألف استدعاء وطلب واحد في الثانية وحداثة بيانات 60 ثانية (أسعار Genesis API).
فرق التمويل: /funding/spread
فرق التمويل هو الفرق بين أعلى معدل وأدنى معدل لعملة ما عبر المنصات بعد التطبيع إلى 8 ساعات. يُفتح المركز القصير حيث المعدل أعلى والطويل حيث هو أدنى: القصير يستلم معدل منصته، والطويل يدفع معدل منصته (أو يستلم عندما يكون المعدل سالباً)، والفرق هو ما يتبقى.
يعيد GET /funding/spread لكل عملة أفضل زوج منصات في best: exchange_1 وexchange_2 ومعدلاتهما حسب فترة كل منهما (funding_1_pct وfunding_2_pct) والفترات وأوقات الدفع وروابط المنصة. فرق الزوج في spread_pct، والمنصات الأخرى في others، والمرشحان coin وmin_spread (توثيق فرق التمويل). كثيراً ما تختلف فترتا الزوج، مثل 1h و8h لـ BTC في مثال التوثيق، لذا لا تقارن معدلي الزوج يدوياً إلا بعد تطبيعهما إلى 8 ساعات.
Python: أعلى 10 فروق تمويل بمعدل سنوي
يأخذ السكربت المجموعة الكاملة من /funding/rates ويجد لكل عملة المنصات ذات أعلى وأدنى funding_8h_pct: الفرق هو فرق 8 ساعات، ويُحوَّل إلى سنوي بالصيغة الفرق × 3 × 365. عند 429 و503 ينتظر Retry-After ثانية، لكن ليس أكثر من دقيقة: فعند استهلاك الحصة الشهرية يمتد Retry-After حتى إعادة تعيين الحصة.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/rates"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch_rates():
for _ in range(3):
r = requests.get(URL, headers=HEADERS, timeout=20)
if r.status_code not in (429, 503):
r.raise_for_status()
return r.json()["data"]
# 429 أو 503: انتظر Retry-After، لكن ليس أكثر من دقيقة
time.sleep(min(int(r.headers.get("Retry-After", "5")), 60))
raise RuntimeError("API did not respond after three attempts")
rows = []
for item in fetch_rates():
ex = [e for e in item["exchanges"]
if e["funding_8h_pct"] is not None]
if len(ex) < 2:
continue
short = max(ex, key=lambda e: e["funding_8h_pct"]) # الساق القصيرة
long_ = min(ex, key=lambda e: e["funding_8h_pct"]) # الساق الطويلة
spread = short["funding_8h_pct"] - long_["funding_8h_pct"]
rows.append((spread, item["coin"], short, long_))
rows.sort(key=lambda x: x[0], reverse=True)
for spread, coin, short, long_ in rows[:10]:
apr = spread * 3 * 365 # APR بسيط على قيمة ساق واحدة
print(f"{coin:<10} short {short['exchange']:<8} "
f"long {long_['exchange']:<8} {spread:.4f}% per 8h "
f"APR {apr:.1f}%, on capital {apr / 2:.1f}%")
الرقم السنوي هنا محسوب على قيمة ساق واحدة. الساقان تحتاجان إلى مال، لذا فالعائد على إجمالي رأس المال دون رافعة نصف ذلك، كما في حقل apr_capital في التحليلات. مثال افتراضي: مركز قصير في منصة بمعدل 0.05% لكل 8 ساعات، وطويل في أخرى بمعدل 0.01%. الفرق 0.05 − 0.01 = 0.04%، وبالتحويل السنوي 0.04 × 3 × 365 = 43.8% للساق الواحدة و21.9% على رأس المال.
الرسوم غير مشمولة. مثال افتراضي: رسم taker بنسبة 0.05% على كل صفقة من أربع صفقات (فتح الساقين وإغلاقهما) يساوي 4 × 0.05 = 0.2% من قيمة الساق. فرق 0.04% يعوّض ذلك خلال 0.2 / 0.04 = 5 تسويات، أي 40 ساعة، إذا بقيت المعدلات كما هي.
لا يُحتسب على الحصة إلا الاستجابة 200. في المراقب لا تستعلم أكثر من مرة كل meta.freshness_sec ثانية وأرسل ETag السابق في If-None-Match: المجموعة الكاملة غير المتغيرة تعود باستجابة 304 غير مفوترة. المزيد في دليل الحدود وفي الدرس 4 من دورة API العملات الرقمية الذي يبني مراقب فروق وتمويل بلغة Python.
سجل التمويل المنفَّذ: /funding/analytics/*
المعدل الحالي يُظهر التسوية التالية؛ والسجل يُظهر ما دُفع فعلاً. يأتي من أربع نقاط نهاية تحليلية: 13 منصة، والمعدلات بالنسبة المئوية لكل فترة تسوية، والطوابع الزمنية بثواني epoch بتوقيت UTC. وهي ضمن خطتي Pro (100 دولار شهرياً) وMax (200 دولار)؛ أما Trial وStart فتحصلان على 403 plan_restricted.
| نقطة النهاية | المحتوى | القسم الكامل |
|---|---|---|
/funding/analytics/summary | المجاميع ومتوسط معدلات 8 ساعات وAPR والتغطية لـ 7 فترات، من يوم واحد إلى سنة | ~600 KB gzip |
/funding/analytics/recent | كل دفعة خلال آخر 7 أيام | ~1 MB gzip |
/funding/analytics/daily | المجاميع اليومية على 365 يوماً | حتى ~12 MB gzip |
/funding/analytics/top | أفضل 50 زوج عملة×منصة وأفضل 50 حزمة قصير/طويل لكل فترة | — |
التنزيلات الكاملة دون coin محدودة: summary وrecent مرة كل 60 ثانية، وdaily مرة كل 300 ثانية لكل مفتاح؛ والطلب قبل انتهاء النافذة يحصل على 429 مع Retry-After. شرائح coin واستجابات 304 غير محدودة، لذا اجلب سجل العملة هكذا:
curl --compressed -G \
"https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
-d coin=BTC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
في summary يحمل كل زوج عملة×منصة الفترة interval_h وبداية البيانات data_since وآخر معدل 8 ساعات last8h للمقارنة «الآن مقابل المعتاد» ومصفوفة m من 14 مقياساً لكل فترة: sum وavg8h وapr وcov وflips وغيرها. مثال من التوثيق: BTC على Binance خلال 7 أيام، 21 تسوية موجبة، avg8h يساوي 0.006298%، وapr يساوي 0.006298 × 3 × 365 ≈ 6.896%. تحليل m وrecent وdaily مشروح في دليل نقاط نهاية التمويل، والحقول في قسم تحليلات التمويل من التوثيق.
سكرينر الحزم top
/funding/analytics/top سكرينر جاهز دون معاملات. ساقا الحزمة فيه دائماً في منصتين مختلفتين بتغطية لا تقل عن 0.9، ولا تدخل القوائم الحزم التي net فيها ≤ 0.
gross هو التمويل الإجمالي للحزمة عن الفترة، وfees رسوم أربع صفقات من جدول taker_fees، وnet = gross − fees. يُحوَّل apr_net إلى سنوي على قيمة ساق واحدة، وapr_capital نصفه، على رأس مال الساقين. win_rate هو حصة الأيام الرابحة، وmax_dd أكبر تراجع، وprice_div فرق السعر الحالي بين الساقين، وهو غير داخل في net.
في مثال التوثيق، حققت حزمة PEPE (قصير على HTX وطويل على Hyperliquid بالرمز 1000PEPE) قيمة gross تبلغ 1.51504% مع fees تساوي 0.19 خلال 7 أيام. إذن net = 1.51504 − 0.19 = 1.32504%، وapr_net يساوي 69.09% وapr_capital 34.55%. القوائم الجاهزة: by_net_apr حسب العائد الصافي، وby_stable للحزم المستقرة، وby_live للعاملة الآن.
معدل التمويل كمؤشر للسوق
عندما يكون المعدل موجباً، يدفع أصحاب المراكز الطويلة ذات الرافعة لأصحاب المراكز القصيرة؛ وعندما يكون سالباً يحدث العكس. المعدل الموجب الصغير طبيعي (تثبّت Hyperliquid مكوّن الفائدة عند 0.01% لكل 8 ساعات)، ويصبح المعدل إشارة حين يبتعد كثيراً عن مستواه المعتاد.
اقرأ المعدل المرتفع مع الفائدة المفتوحة: عندما يرتفعان معاً تتراكم مراكز كثيرة ذات رافعة في جهة واحدة، وأي حركة عكسها تطلق سلسلة تصفيات. يعيد /market/open-interest الفائدة المفتوحة حسب المنصة (قسم التوثيق). المزيد في معدل التمويل كمؤشر للسوق.
مخاطر أربيتراج التمويل
حزمة قصير/طويل عبر منصتين لا تكاد تعتمد على السعر، لكن يمكنك أن تخسر فيها مع ذلك:
- يتغير المعدل قبل التسوية وقد تنقلب إشارته، ولا يُدفع إلا للمركز المفتوح لحظة التسوية؛
- تتباعد أسعار الساقين: إذا كان سعر منصة القصير أدنى من سعر منصة الطويل يبدأ الدخول بخسارة، فتحقق من
priceأوprice_div؛ - الرسوم والانزلاق: هناك أربع صفقات، وفي دفتر أوامر ضعيف السيولة يكلّف الدخول أكثر مما يُظهره الجدول؛
- تصفية إحدى الساقين: لا ينتقل الهامش بين المنصات، وتُطلق التصفية على سعر العلامة؛
- قد تغيّر المنصة فترة العقد أو سقف معدله؛ وفي Binance تُدرج هذه العقود في
fundingInfo.
بدون كود، المعدلات نفسها في جدول أربيتراج التمويل (الدليل)، وحاسبة الفرق تحسب الحزمة مع الرسوم، ونظرة على API العملات الرقمية تقارن واجهات بيانات السوق بوجه عام.
أسئلة وأجوبة
أين أحصل على معدلات التمويل التاريخية؟
تحتفظ المنصات بالسجل بصيغها الخاصة: GET /fapi/v1/fundingRate في Binance، وGET /v5/market/funding/history في Bybit، والنوع fundingHistory في Hyperliquid. يعيد Genesis API سجل 13 منصة بصيغة واحدة: /funding/analytics/recent لدفعات 7 أيام، و/funding/analytics/daily للمجاميع اليومية على سنة، و/funding/analytics/summary لمجاميع الفترات، ضمن خطتي Pro وMax.
لماذا تختلف معدلات التمويل بين المنصات؟
لكل منصة متداولوها وسيولتها وصيغة معدلها وسقوفها، فيتراكم اختلال المراكز بشكل مختلف. وتختلف الفترات أيضاً: 8 أو 4 ساعات في المنصات المركزية، وكل ساعة في Hyperliquid. قارن المعدلات بعد تطبيعها إلى فترة واحدة؛ وفي Genesis API هذا هو الحقل funding_8h_pct.
كم مرة تُحدَّث معدلات التمويل في API؟
المعدل الحالي في المنصة يتغير حتى التسوية؛ أما المعدل المنفَّذ فيثبت ويدخل السجل. حداثة بيانات Genesis API هي 60 ثانية في Trial و30 ثانية في Start و10 ثوانٍ في Pro و5 ثوانٍ في Max؛ ويتغير ETag لملخص التحليلات كل 15 دقيقة تقريباً، وتُعاد بناء المجاميع اليومية كل ساعة.
هل يوجد API مجاني لمعدل التمويل؟
ليس في Genesis API خطة مجانية: معدلات التمويل والفرق ضمن Trial بسعر 20 دولاراً شهرياً، والسجل ضمن Pro بسعر 100 دولار وMax بسعر 200 دولار. في الموقع تظهر معدلات التمويل والفروق دون خطة في أربيتراج التمويل.