اندپوینتهای فاندینگ 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/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 بفرستید.
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]
}
}
}
}
}
}
| معیار | اندیس | معنی |
|---|---|---|
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 برای دورههای 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 پایداری را بهتر نشان میدهند. بقیه فیلدهای جفت:
data_since— آغاز دادهها؛ پیش از این تاریخ صفر نکشید.last8h— آخرین نرخ بر مبنای 8 ساعت، برای مقایسه «اکنون در برابر معمول».interval_h— دوره تسویه: 8 یا 4 ساعت در CEX و 1 ساعت در 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 باندل شورت/لانگ برتر. پایههای باندل همیشه روی صرافیهای متفاوتاند با پوشش دستکم 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 — شورت در 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%. شکاف قیمت بین دو پایه، لغزش و مارجین لحاظ نشدهاند.
چطور مانیتور فاندینگ بسازیم
نامزدها را پیدا کنید
/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 محدودیت ندارند.