مستندات Genesis API

هرچه برای یکپارچه‌سازی لازم است: احراز هویت، محدودیت‌ها، اندپوینت‌ها و اسکیمای پاسخ.

مستنداتتحلیل فاندینگ

تحلیل فاندینگ

TrialStartProMax

تحلیل تاریخی فاندینگ تسویه‌شده در ۱۳ صرافی — بخشی با چهار اندپوینت. همه نرخ‌ها درصد به‌ازای دوره تسویه و زمان‌ها ثانیه epoch UTC. در Pro و Max؛ سایر پلن‌ها 403 plan_restricted می‌گیرند. بخش‌های کامل بزرگ‌اند — از پارامتر coin و هدر If-None-Match استفاده کنید (ETag با generated_at عوض می‌شود). دانلود کامل بدون coin محدود است: summary و recent هر ۶۰ ثانیه یک‌بار و daily هر ۳۰۰ ثانیه یک‌بار به‌ازای هر کلید؛ پاسخ‌های 304 و درخواست‌های coin محدودیتی ندارند.

امتحان درخواست
GET/v1/funding/analytics/summary

کلید فقط در مرورگر شما ذخیره می‌شود و جز به API جایی فرستاده نمی‌شود.

کلید را بچسبانید و درخواست بزنید — پاسخ خلاصه‌شده را نشان می‌دهیم.

تحلیل: خلاصه

خلاصه تاریخی فاندینگ تسویه‌شده برای هر جفت کوین×صرافی: مبالغ انباشته، نرخ‌های میانگین ۸س، APR و پوشش در ۷ دوره از ۱ روز تا یک سال. در Pro و Max. بخش کامل ~۶۰۰ کیلوبایت gzip — برای یک کوین از پارامتر coin استفاده کنید و هنگام پولینگ If-None-Match بفرستید (ETag هر ~۱۵ دقیقه عوض می‌شود).

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/summary

پارامترهای درخواست

پارامترنوعتوضیح
coinstringبرگرداندن برش فقط یک کوین (توصیه‌شده: بخش کامل بزرگ است)

نمونه پاسخ

json
{
  "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_orderstring[]ترتیب معیارها در آرایه m: sum, avg8h, apr, n, pos, neg, zero, min, max, cov
periodsstring[]دوره‌های موجود 1d…365d؛ وقتی هیچ داده‌ای نیست دوره در m غایب است
coins.{c}.canon / multstring / numberنام استاندارد برای ادغام واریانت‌ها (1000PEPE→PEPE) و ضریب قرارداد؛ mult هرگز به نرخ‌ها اعمال نمی‌شود
…exchanges.{ex}.interval_hnumberبازه تسویه به ساعت: 8/4 در CEX و 1 در Hyper و Lighter
…exchanges.{ex}.data_sincenumberشروع داده‌ها (ثانیه epoch)؛ قبل از این تاریخ صفر رسم نکنید
…exchanges.{ex}.last8hnumber | nullLatest actual rate in 8h equivalent — the “now vs norm” comparison
…exchanges.{ex}.m.{period}(number | null)[14]آرایه معیارهای دوره به ترتیب metric_order (۱۴ فیلد: sum, avg8h, apr, n, pos, neg, zero, min, max, cov, med8h, pos_streak, neg_streak, flips)؛ ایندکس‌های ۱۰–۱۳ برای 1d و 3d برابر null هستند
m[9] (cov)number 0..1پوشش دوره 0..1؛ زیر 0.9 داده جزئی است — در رابط علامت بزنید

تحلیل: پرداخت‌ها ۷ر

هر پرداخت فاندینگ ۷ روز اخیر برای نمودارهای 1D/3D/7D. نرخ‌ها درصد به‌ازای دوره تسویه و زمان‌ها ثانیه epoch UTC. Pro و Max؛ بخش کامل ~۱ مگابایت gzip — coin توصیه می‌شود.

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/recent

پارامترهای درخواست

پارامترنوعتوضیح
coinstringبرگرداندن برش فقط یک کوین (توصیه‌شده: بخش کامل بزرگ است)

نمونه پاسخ

json
{
  "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 }
}

فیلدهای پاسخ

فیلدنوعتوضیح
daysnumberعمق داده بخش به روز
coins.{c}.{ex}.inumberبازه تسویه به ساعت: 8/4 در CEX و 1 در Hyper و Lighter
coins.{c}.{ex}.sstringرشته نقاط ts:rate;ts:rate;… صعودی زمانی؛ ts ثانیه epoch

تحلیل: روزها ۱س

مبالغ روزانه فاندینگ ۳۶۵ روز برای نمودارهای 1M/3M/1Y. با کامل شدن تاریخچه بخش بزرگ می‌شود (~۱۲ مگابایت gzip) — از coin و If-None-Match استفاده کنید؛ هر ساعت بازتولید می‌شود.

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/daily

پارامترهای درخواست

پارامترنوعتوضیح
coinstringبرگرداندن برش فقط یک کوین (توصیه‌شده: بخش کامل بزرگ است)

نمونه پاسخ

json
{
  "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 }
}

فیلدهای پاسخ

فیلدنوعتوضیح
daysnumberعمق داده بخش به روز
coins.{c}.{ex}stringرشته روزها day_ts:sum:pos:neg;… — نیمه‌شب UTC، مجموع روز، تسویه‌های مثبت و منفی

تحلیل: اسکرینر

اسکرینر آماده: ۵۰ جفت برتر کوین×صرافی بر اساس فاندینگ انباشته و ۵۰ باندل برتر short/long برای هر دوره. پاهای باندل همیشه روی صرافی‌های متفاوت با پوشش ≥0.9 هستند. gross پیش از کارمزد است، net پس از کارمزدهای تیکر چهار معامله؛ تفاوت قیمت پاها لحاظ نمی‌شود. Pro و Max.

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/top

نمونه پاسخ

json
{
  "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_feesobjectThe taker-fee table applied when computing fees
periods.{p}.by_net_apr / by_stable / by_livearrayby_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 / netnumbernet = gross − fees: نتیجه باندل پس از کارمزد چهار معامله؛ ردیفی با net ≤ 0 نمایش داده نمی‌شود
bundle.apr_net / apr_capitalnumberapr_net — سالانه بر نوشنال یک پا؛ apr_capital = apr_net / 2 — بر سرمایه واقعی (هر دو پا سرمایه می‌خواهند)
bundle.win_rate / max_dd / worst_streak / risk_daysnumberwin_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_divnumber | nulllive_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_symstringتیکرهای واقعی پاها در صرافی‌ها — ممکن است متفاوت باشند (PEPE و 1000PEPE)
periods.{p}.by_sum_pos / by_sum_negarray۵۰ برتر بر اساس فاندینگ انباشته (فقط cov ≥ 0.5)