توثيق Genesis API
كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.
تحليلات التمويل
تحليلات تاريخية للتمويل المسدَّد عبر 13 منصة — قسم من أربعة نقاط نهاية. كل المعدلات نسب مئوية لكل فترة تسوية والأوقات بثواني epoch UTC. متاح على Pro وMax؛ الخطط الأخرى تتلقى 403 plan_restricted. الأقسام الكاملة كبيرة — استخدم معامل coin ورأس If-None-Match (يتبع ETag قيمة generated_at). التنزيل الكامل من دون coin محدود: summary وrecent مرة كل 60 ثانية وdaily مرة كل 300 ثانية لكل مفتاح؛ ردود 304 وطلبات coin غير محدودة.
/v1/funding/analytics/summaryيُحفظ المفتاح في متصفحك فقط ولا يُرسل إلى أي جهة سوى الـ API.
الصق مفتاحك وأرسل طلباً — سنعرض استجابة مختصرة.
التحليلات: الملخص
ملخص تاريخي للتمويل المسدَّد لكل زوج عملة×منصة: مبالغ متراكمة ومتوسط معدلات 8س وAPR والتغطية عبر 7 فترات من يوم إلى سنة. متاح على Pro وMax. القسم الكامل ~600 كيلوبايت gzip — استخدم معامل coin لعملة واحدة وأرسل If-None-Match عند الاستطلاع (يتغير ETag كل ~15 دقيقة).
https://api.genesisarbitrage.com/v1/funding/analytics/summaryمعاملات الطلب
| المعامل | النوع | الوصف |
|---|---|---|
coin | string | إرجاع شريحة عملة واحدة فقط (موصى به: القسم الكامل كبير) |
مثال استجابة
{
"success": true,
"data": {
"schema_version": 1,
"units": "percent",
"generated_at": 1785546602,
"metric_order": ["sum","avg8h","apr","n","pos","neg","zero","min","max","cov",
"med8h","pos_streak","neg_streak","flips"],
"periods": ["1d","3d","7d","30d","90d","180d","365d"],
"coins": {
"BTC": {
"canon": "BTC",
"mult": 1,
"exchanges": {
"Binance": {
"raw_symbol": "BTCUSDT",
"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]
}
}
}
}
}
},
"meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
metric_order | string[] | ترتيب المقاييس في مصفوفة m: sum, avg8h, apr, n, pos, neg, zero, min, max, cov |
periods | string[] | الفترات المتاحة 1d…365d؛ تغيب الفترة من m عندما لا توجد بيانات إطلاقاً |
coins.{c}.canon / mult | string / number | الاسم القياسي لدمج المتغيرات (1000PEPE→PEPE) ومضاعف العقد؛ لا يُطبَّق mult على المعدلات أبداً |
…exchanges.{ex}.interval_h | number | فاصل التسوية بالساعات: 8/4 على CEX و1 على Hyper وLighter |
…exchanges.{ex}.data_since | number | بداية البيانات (ثواني epoch)؛ لا ترسم أصفاراً قبل هذا التاريخ |
…exchanges.{ex}.last8h | number | null | Latest actual rate in 8h equivalent — the “now vs norm” comparison |
…exchanges.{ex}.m.{period} | (number | null)[14] | مصفوفة مقاييس الفترة بترتيب metric_order (14 حقلاً: sum, avg8h, apr, n, pos, neg, zero, min, max, cov, med8h, pos_streak, neg_streak, flips)؛ المؤشرات 10–13 تساوي null للفترتين 1d و3d |
m[9] (cov) | number 0..1 | تغطية الفترة 0..1؛ تحت 0.9 البيانات جزئية — أشِر إلى ذلك في الواجهة |
التحليلات: دفعات 7أ
كل دفعة تمويل خلال آخر 7 أيام لرسوم 1D/3D/7D. المعدلات نسب مئوية لكل فترة تسوية والأوقات بثواني epoch UTC. Pro وMax؛ القسم الكامل ~1 ميغابايت gzip — يُنصح بـ coin.
https://api.genesisarbitrage.com/v1/funding/analytics/recentمعاملات الطلب
| المعامل | النوع | الوصف |
|---|---|---|
coin | string | إرجاع شريحة عملة واحدة فقط (موصى به: القسم الكامل كبير) |
مثال استجابة
{
"success": true,
"data": {
"units": "percent",
"generated_at": 1785546602,
"days": 7,
"coins": {
"BTC": {
"Lighter": { "i": 1.0, "s": "1784941200:0.0012;1784944800:0.001;1784948400:0.0002" }
}
}
},
"meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
days | number | عمق بيانات القسم بالأيام |
coins.{c}.{ex}.i | number | فاصل التسوية بالساعات: 8/4 على CEX و1 على Hyper وLighter |
coins.{c}.{ex}.s | string | سلسلة نقاط ts:rate;ts:rate;… تصاعدية زمنياً؛ ts بثواني epoch |
التحليلات: أيام سنة
مبالغ التمويل اليومية لـ365 يوماً لرسوم 1M/3M/1Y. مع اكتمال التاريخ يصبح القسم كبيراً (~12 ميغابايت gzip) — استخدم coin وIf-None-Match؛ يتجدد كل ساعة.
https://api.genesisarbitrage.com/v1/funding/analytics/dailyمعاملات الطلب
| المعامل | النوع | الوصف |
|---|---|---|
coin | string | إرجاع شريحة عملة واحدة فقط (موصى به: القسم الكامل كبير) |
مثال استجابة
{
"success": true,
"data": {
"units": "percent",
"generated_at": 1785546602,
"days": 365,
"coins": {
"BTC": { "OKX": "1784937600:0.0027:1:1;1785024000:0.008:3:0" }
}
},
"meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
days | number | عمق بيانات القسم بالأيام |
coins.{c}.{ex} | string | سلسلة أيام day_ts:sum:pos:neg;… — منتصف الليل UTC ومجموع اليوم وعدد التسويات الموجبة والسالبة |
التحليلات: سكرينر
سكرينر جاهز: أفضل 50 زوج عملة×منصة بالتمويل المتراكم وأفضل 50 رابطة short/long لكل فترة. ساقا الرابطة دائماً على منصتين مختلفتين بتغطية ≥0.9. gross قبل الرسوم، وnet بعد رسوم التيكر لأربع صفقات؛ فارق السعر بين الساقين غير مشمول. Pro وMax.
https://api.genesisarbitrage.com/v1/funding/analytics/topمثال استجابة
{
"success": true,
"data": {
"schema_version": 1,
"units": "percent",
"generated_at": 1785545651,
"taker_fees": { "Binance": 0.05, "Bybit": 0.055, "HTX": 0.05, "Hyper": 0.045, "Lighter": 0.0 },
"periods": {
"7d": {
"by_net_apr": [
{
"coin": "PEPE",
"short_ex": "HTX", "short_sym": "PEPE", "short_iv": 8.0,
"long_ex": "Hyper", "long_sym": "1000PEPE", "long_iv": 1.0,
"gross": 1.51504, "fees": 0.19, "net": 1.32504,
"apr_net": 69.09, "apr_capital": 34.55,
"win_rate": 1.0, "max_dd": 0.0, "worst_streak": 0, "risk_days": 7,
"trend_1d": 0.0471, "trend_7d": 1.515,
"live_8h": 0.012, "price_div": 0.11, "cov": 1.0
}
],
"by_stable": [ { "...": "same shape, win_rate >= 0.7" } ],
"by_live": [ { "...": "same shape, live_8h > 0 and trend_1d > 0" } ],
"by_sum_pos": [
{ "coin": "AAOI", "canon": "AAOI", "ex": "Lighter",
"sum": 11.5165, "apr": 600.5, "cov": 1.0,
"med8h": 0.062, "pos_streak": 7, "neg_streak": 0, "flips": 0,
"iv": 1.0, "last8h": 0.058 }
],
"by_sum_neg": [ { "...": "same shape as by_sum_pos" } ]
}
}
},
"meta": { "count": 7, "updated_at": 1785545651, "schema_version": 1 }
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
taker_fees | object | The taker-fee table applied when computing fees |
periods.{p}.by_net_apr / by_stable / by_live | array | by_net_apr — ranked by net yield; by_stable — win_rate ≥ 0.7 and drawdown ≤ half of gross; by_live — live_8h > 0 and trend_1d > 0; by_sum_pos / by_sum_neg — single-exchange tops |
bundle.gross / fees / net | number | net = gross − fees: نتيجة الرابطة بعد رسوم أربع صفقات؛ لا تظهر صفوف بـ net ≤ 0 |
bundle.apr_net / apr_capital | number | apr_net — سنوي على قيمة ساق واحدة؛ apr_capital = apr_net / 2 — على رأس المال المستثمر (الساقان تحتاجان تمويلاً) |
bundle.win_rate / max_dd / worst_streak / risk_days | number | win_rate — share of profitable days (0..1), max_dd — max drawdown of the cumulative curve, worst_streak — longest run of losing days, risk_days — days the risk was measured over (max 90) |
bundle.live_8h / trend_1d / trend_7d / price_div | number | null | live_8h — current rate difference in 8h equivalent; trend_1d / trend_7d — gross spread over the last day and week; price_div — current futures price divergence (null when prices unavailable) |
bundle.short_sym / long_sym | string | تيكرات الساقين الفعلية على المنصتين — قد تختلف (PEPE و1000PEPE) |
periods.{p}.by_sum_pos / by_sum_neg | array | أفضل 50 بالتمويل المتراكم (cov ≥ 0.5 فقط) |