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 تکرار کنید.

API نرخ فاندینگ در Genesis API مجموعه‌ای از اندپوینت‌ها با نرخ‌های فاندینگ قراردادهای دائمی در صرافی‌های مختلف، بهترین جفت صرافی بر اساس اسپرد فاندینگ و تاریخچه فاندینگ تسویه‌شده است. نرخ‌های جاری و اسپرد در همه پلن‌های API هستند؛ تحلیل تاریخی 13 صرافی در Pro و Max. سایت همین داده‌ها را در Funding Arbitrage نشان می‌دهد، راهنما را ببینید.

اندپوینت‌های فاندینگ و پلن‌ها

اندپوینتچه برمی‌گرداندپلن‌های API
/funding/ratesنرخ هر صرافی برای هر کوینTrial، Start، Pro، Max
/funding/spreadبهترین جفت صرافی بر اساس اسپرد و بقیه صرافی‌هاTrial، Start، Pro، Max
/funding/analytics/summaryخلاصه برای دوره‌های 1 روز تا یک سال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 داده‌های فاندینگ، مقاله 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/top50 جفت برتر و 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 بفرستید.

summary و آرایه m

هر جفت کوین×صرافی در summary فیلد 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 برای دوره‌های 1d و 3d برابر null هستند. با 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 باندل شورت/لانگ برتر. پایه‌های باندل همیشه روی صرافی‌های متفاوت‌اند با پوشش دست‌کم 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 — شورت در HTX و لانگ در Hyperliquid — در 7 روز gross برابر 1.51504% داشت. کارمزدها 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 محدودیت ندارند.