Genesis Arbitrage

Genesis Arbitrage · · 13 دقیقه مطالعه

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 هر 4 ساعت 0.02% دریافت می‌کند: 0.02 × 8 / 4 = 0.04% در هر 8 ساعت. یک نمونه‌ی فرضی با دوره‌ی ساعتی: صرافی A هر ساعت 0.004% می‌پردازد و صرافی B هر 8 ساعت 0.02%. با اعداد خام A یک‌پنجم می‌پردازد، اما در 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 نرخ فاندینگ خودش را دارد: مسیرها، فیلدها و روش اعلام دوره‌ی خودش.

صرافینرخ فعلیتاریخچهدوره
BinanceGET /fapi/v1/premiumIndexGET /fapi/v1/fundingRateGET /fapi/v1/fundingInfo
BybitGET /v5/market/tickersGET /v5/market/funding/historyفیلد fundingIntervalHour
OKXGET /api/v5/public/funding-rateGET /api/v5/public/funding-rate-historyاز fundingTime و nextFundingTime
HyperliquidPOST /info, metaAndAssetCtxsPOST /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).

برای ادغام این صرافی‌ها در یک جدول، کد شما باید:

همه‌ی صرافی‌ها در یک درخواست: /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 هزار فراخوانی، 1 درخواست در ثانیه، تازگی داده 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: ده اسپرد فاندینگ برتر، سالانه‌شده

اسکریپت مجموعه‌ی کامل /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% روی سرمایه.

کارمزدها در نظر گرفته نشده‌اند. یک نمونه‌ی فرضی: کارمزد تیکر 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 بازه، از 1 روز تا یک سال~600 KB gzip
/funding/analytics/recentهمه‌ی پرداخت‌های 7 روز اخیر~1 MB gzip
/funding/analytics/dailyمجموع روزانه در 365 روزتا ~12 MB gzip
/funding/analytics/top50 جفت برتر کوین×صرافی و 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) در 7 روز gross برابر 1.51504% با fees برابر 0.19 داشت. پس 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 اوپن اینترست را به تفکیک صرافی برمی‌گرداند (بخش مستندات). بیشتر در نرخ فاندینگ به‌عنوان شاخص بازار.

ریسک‌های آربیتراژ فاندینگ

بسته‌ی شورت/لانگ در دو صرافی تقریباً به قیمت وابسته نیست، اما باز هم می‌توانید در آن ضرر کنید:

بدون کد، همین نرخ‌ها در جدول آربیتراژ فاندینگ هستند (راهنما)، ماشین‌حساب اسپرد بسته را با کارمزد حساب می‌کند و مرور API ارز دیجیتال 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 در Trial برابر 60 ثانیه، در Start برابر 30 ثانیه، در Pro برابر 10 ثانیه و در Max برابر 5 ثانیه است؛ ETag خلاصه‌ی تحلیل تقریباً هر 15 دقیقه عوض می‌شود و مجموع‌های روزانه هر ساعت بازسازی می‌شوند.

آیا API نرخ فاندینگ رایگان وجود دارد؟

Genesis API پلن رایگان ندارد: نرخ‌های فاندینگ و اسپرد در Trial با 20 دلار در ماه هستند و تاریخچه در Pro با 100 دلار و Max با 200 دلار. در سایت، نرخ‌های فاندینگ و اسپردها بدون پلن در آربیتراژ فاندینگ دیده می‌شوند.