نقاط نهاية التمويل في 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]
}
}
}
}
}
}
| المقياس | الفهرس | المعنى |
|---|---|---|
sum | 0 | المتراكم خلال الفترة، % |
avg8h | 1 | متوسط المعدل بمعيار 8 ساعات، % |
apr | 2 | القيمة السنوية، % |
n | 3 | عدد التسويات |
pos، neg، zero | 4–6 | التسويات الموجبة والسالبة والصفرية |
min، max | 7–8 | أصغر تسوية وأكبرها، % |
cov | 9 | تغطية الفترة من 0 إلى 1 |
med8h | 10 | الوسيط بمعيار 8 ساعات، % |
pos_streak، neg_streak | 11–12 | أيام متتالية موجبة وسالبة |
flips | 13 | تغيّرات الإشارة |
الفهارس 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 تبيّن الاستقرار بصورة أفضل. بقية حقول الزوج:
data_since— بداية البيانات؛ لا ترسم أصفاراً قبل هذا التاريخ.last8h— آخر معدل بمعيار 8 ساعات، لمقارنة «الآن مقابل المعتاد».interval_h— فترة التسوية: 8 أو 4 ساعات في CEX، وساعة واحدة في Hyperliquid وLighter.canonوmult— الاسم الذي يدمج صيغ الرمز (1000PEPE←PEPE) ومضاعف العقد؛ ولا يُطبَّقmultعلى المعدلات أبداً.
الدفعات خلال 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.
by_net_apr— حسب العائد الصافي.by_stable—win_rate≥ 0.7 وتراجع لا يتجاوز نصف الإجمالي.by_live—live_8h> 0 وtrend_1d> 0.by_sum_pos،by_sum_neg— قوائم منصة واحدة حسب التمويل المتراكم، معcov≥ 0.5 فقط.
| حقل الحزمة | المعنى |
|---|---|
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%. فجوة السعر بين الساقين والانزلاق السعري والهامش غير محسوبة.
كيف تبني مراقب تمويل
ابحث عن المرشحين
اطلب
/funding/spreadمعmin_spread(في أي خطة API) ورتّب حسبspread_pct.تحقق من المعدلات والدفعات
اطلب
/funding/ratesمعcoin: الحقولintervalوnext_payoutوfunding_8h_pctعلى المنصتين. يجب أن يكون المركز مفتوحاً وقت التسوية.انظر إلى السجل
في Pro وMax اطلب
/funding/analytics/summaryمعcoin: قيمsumوaprوcovوflipsلفترتي 7d و30d تبيّن هل الفجوة في المعدلات مستمرة.قيّم الحزمة كاملة
في
/funding/analytics/topقارنnetوapr_capitalوwin_rateوmax_ddوprice_divالحالي.افتح المراكز بنفسك
تقود روابط
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 بلا حد.