Genesis API fonlama endpoint'leri: oranlar, spread ve fonlama geçmişi analitiği
Kısaca
/funding/ratesve/funding/spreadher API planında var: her borsanın aralık başına ve 8 saatlik oranı, sonraki ödeme zamanı ve spread'e göre en iyi borsa çifti.- Gerçekleşen fonlama analitiği, 13 borsada bir yıla kadar geçmişi olan dört
/funding/analytics/…endpoint'idir ve Pro ile Max planlarındadır. - Tam summary, recent ve daily indirmeleri gzip ile ~12 MB'a kadar çıkar ve 60–300 saniyede bir yapılabilir:
coindilimi alın veya isteğiIf-None-Matchile tekrarlayın.
Genesis API'deki fonlama oranı API'si, borsalardaki sürekli vadeli işlem fonlama oranlarını, fonlama spread'ine göre en iyi borsa çiftini ve gerçekleşen fonlama geçmişini veren endpoint'lerden oluşur. Güncel oranlar ve spread her API planında var; 13 borsanın geçmiş analitiği Pro ve Max planlarında. Site aynı verileri Funding Arbitrage bölümünde gösterir, bkz. rehber.
Fonlama endpoint'leri ve planlar
| Endpoint | Döndürür | API planları |
|---|---|---|
/funding/rates | Her coin için tüm borsaların oranları | Trial, Start, Pro, Max |
/funding/spread | Spread'e göre en iyi borsa çifti ve diğer borsalar | Trial, Start, Pro, Max |
/funding/analytics/summary | 1 günden bir yıla kadar dönemlerin özeti | Pro, Max |
/funding/analytics/recent | 7 gündeki tüm ödemeler | Pro, Max |
/funding/analytics/daily | 365 günlük günlük toplamlar | Pro, Max |
/funding/analytics/top | Çiftlerin ve borsa kombinasyonlarının taraması | Pro, Max |
Parametreler ve alanlar dokümantasyonun Fonlama oranları, Fonlama spread'i ve Fonlama analitiği bölümlerinde. Trial ve Start planlarında analitik endpoint'leri 403 plan_restricted döndürür. Fonlama veri API'lerine genel bakış için fonlama oranı API'si makalesine bakın. Aşağıdaki yanıt örnekleri data alanını kısaltılmış halde gösterir.
Oranlar ve 8 saate normalizasyon
/funding/rates, her coin için güncel oranlı bir borsa listesi döndürür. coin ve exchange filtreleri (birden fazla borsa için virgülle ayrılır) isteğe bağlıdır.
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"
}
]
}
| Alan | Anlamı |
|---|---|
funding_pct | Ödeme aralığı başına oran, % |
funding_8h_pct | 8 saate normalize edilmiş oran, % |
interval | Ödeme aralığı, örn. 8h; null — veri yok |
next_payout | Sonraki ödeme zamanı, SS:DD UTC; null — veri yok |
price, trade_url | Fiyat ve borsanın işlem terminaline bağlantı |
Varsayımsal bir örnek: saatlik %0,005 oran, 8 saatte 0,005 × 8 / 1 = %0,04 eder, yani MEXC ile aynıdır; tek fark sekiz kez ödenmesi ve bir sonraki saatte değişebilmesidir.
Bileşik hesaplanmadan yıllıklandırıldığında 8 saatlik oran × 3 × 365 APR verir. Varsayımsal bir örnek: her 8 saatte %0,01, oran korunduğu sürece yılda 0,01 × 3 × 365 = %10,95 eder. Oranın piyasa hakkında ne söylediği Piyasa göstergesi olarak fonlama oranı yazısında anlatılıyor.
Fonlama spread'i: en iyi borsa çifti
/funding/spread, her coin için fonlama spread'ine göre en iyi borsa çiftini (best) ve diğer borsaları (others) döndürür. Filtreler: coin ve min_spread, yani % cinsinden minimum 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, en iyi çiftin spread'i, %. funding_1_pct ve funding_2_pct kendi aralıklarına (interval_1, interval_2) göre oranlardır: elle karşılaştırmak için ikisini de 8 saate normalize edin. Short oranın yüksek olduğu yere, long düşük olduğu yere açılır. Yanıtlarda Hyperliquid Hyper olarak görünür.
Python betiği, en yüksek spread_pct değerine (%0,05'ten itibaren) sahip on coini ve çiftin ödeme aralıklarını yazdırır. 429 ve 503 durumunda Retry-After saniye bekler; döngüde isteği meta.freshness_sec süresinde en fazla bir kez tekrarlayın.
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
# rate limit or data being rebuilt: wait and retry
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"]}')
Gerçekleşen fonlama analitiği
Dört /funding/analytics/… endpoint'i, 13 borsanın gerçekleşen fonlama geçmişini döndürür; Funding Arbitrage'daki Analitik sekmesiyle aynı veriler. Oranlar ödeme dönemi başına yüzdedir, zaman damgaları UTC epoch saniyesidir.
| Endpoint | İçerik | Tam bölüm | coin olmadan en fazla |
|---|---|---|---|
/funding/analytics/summary | 7 dönem için toplamlar, ortalama oranlar, APR ve kapsam | ~600 KB gzip | 60 sn'de bir |
/funding/analytics/recent | 7 gündeki tüm ödemeler | ~1 MB gzip | 60 sn'de bir |
/funding/analytics/daily | 365 günlük günlük toplamlar | ~12 MB gzip'e kadar | 300 sn'de bir |
/funding/analytics/top | Dönem başına en iyi 50 çift ve en iyi 50 kombinasyon | — | limit yok |
Pencere dolmadan yapılan tam indirme, Retry-After ile 429 alır. ETag ve sıkıştırma kuralları yanıt formatı ve hatalar rehberinde anlatılıyor.
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 sıkıştırılmış yanıt ister ve açar, -i ise ETag dahil başlıkları yazdırır. İlk isteği If-None-Match olmadan gönderin.
Summary ve m dizisi
Summary'deki her coin×borsa çiftinde m var: anahtar bir dönemdir (1d, 3d, 7d, 30d, 90d, 180d, 365d), değer ise metric_order sırasıyla 14 sayıdır. Bir dönem için hiç veri yoksa o dönem m içinde bulunmaz.
{
"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]
}
}
}
}
}
}
| Metrik | İndeks | Anlamı |
|---|---|---|
sum | 0 | Dönem boyunca birikmiş toplam, % |
avg8h | 1 | 8 saat cinsinden ortalama oran, % |
apr | 2 | Yıllıklandırılmış, % |
n | 3 | Ödeme sayısı |
pos, neg, zero | 4–6 | Pozitif, negatif ve sıfır ödemeler |
min, max | 7–8 | En küçük ve en büyük ödeme, % |
cov | 9 | 0'dan 1'e dönem kapsamı |
med8h | 10 | 8 saat cinsinden medyan, % |
pos_streak, neg_streak | 11–12 | Art arda pozitif ve negatif gün sayısı |
flips | 13 | İşaret değişimleri |
1d ve 3d dönemlerinde 10–13 numaralı indeksler null olur. cov < 0,9 ise veri dönemin yalnızca bir kısmını kapsar, bu yüzden bu değerleri işaretleyin. Örnekte Binance'teki BTC için 7 gün: 21 ödeme, hepsi pozitif, cov 1,0 ve apr, avg8h × 3 × 365'e eşit: 0,006298 × 1095 ≈ 6,896.
avg8h, med8h değerinin belirgin biçimde üzerindeyse ortalamayı bir sıçrama şişirmiştir: istikrarı medyan, pos_streak ve flips daha iyi gösterir. Çiftin diğer alanları:
data_since— verinin başladığı zaman; bu tarihten önce sıfır çizmeyin.last8h— 8 saat cinsinden son oran, "şimdi ve norm" karşılaştırması için.interval_h— ödeme aralığı: CEX'lerde 8 veya 4 saat, Hyperliquid ve Lighter'da 1 saat.canonvemult— ticker varyantlarını birleştiren ad (1000PEPE→PEPE) ve kontrat çarpanı;multoranlara asla uygulanmaz.
7 günlük ödemeler ve günlük toplamlar
/funding/analytics/recent içinde her borsada, artan zaman sırasıyla ts:rate;ts:rate;… biçiminde bir s dizesi ve saat cinsinden bir i aralığı bulunur. /funding/analytics/daily içinde day_ts:sum:pos:neg;… dizesi UTC gece yarısını, günün toplamını ve pozitif ile negatif ödeme sayılarını taşır.
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
Kombinasyon taraması
/funding/analytics/top parametresiz hazır bir taramadır: her dönem için birikmiş fonlamaya göre en iyi 50 coin×borsa çifti ve en iyi 50 short/long kombinasyonu. Kombinasyonun bacakları her zaman farklı borsalardadır, kapsam en az 0,9'dur ve net ≤ 0 olan satırlar hiç görünmez.
by_net_apr— net getiriye göre.by_stable—win_rate≥ 0,7 ve düşüş brütün yarısından büyük değil.by_live—live_8h> 0 vetrend_1d> 0.by_sum_pos,by_sum_neg— birikmiş fonlamaya göre tek borsalık listeler, yalnızcacov≥ 0,5.
| Kombinasyon alanı | Anlamı |
|---|---|
gross, fees, net | Brüt fonlama, taker_fees'e göre dört işlemin komisyonu ve net = gross − fees |
apr_net, apr_capital | Bir bacağın nominaline göre yıllıklandırılmış getiri ve iki bacağın sermayesine göre apr_net / 2 |
win_rate, max_dd | Kârlı günlerin payı (0..1) ve kümülatif sonucun maksimum düşüşü |
worst_streak, risk_days | Zararlı günlerin en uzun serisi ve riskin ölçüldüğü gün sayısı, en fazla 90 |
live_8h, trend_1d, trend_7d | 8 saat üzerinden güncel oran farkı ile son gün ve son haftanın brüt spread'i |
price_div | Bacaklar arasındaki güncel fiyat farkı; fiyatlar yoksa null |
short_sym, long_sym | Borsalardaki gerçek bacak ticker'ları; farklı olabilir: PEPE ve 1000PEPE |
Dokümantasyondaki örnekte, HTX'te short ve Hyperliquid'de long olan PEPE kombinasyonu 7 günde %1,51504 gross kazandı. Komisyonlar HTX'te açılış ve kapanış için %0,05'er, Hyperliquid'de %0,045'er: 0,05 × 2 + 0,045 × 2 = 0,19.
Böylece net = 1,51504 − 0,19 = %1,32504, apr_net = 1,32504 × 365 / 7 ≈ %69,09, apr_capital = 69,09 / 2 ≈ %34,55. Bacaklar arasındaki fiyat farkı, slippage ve teminat dahil değildir.
Fonlama monitörü nasıl kurulur
Adayları bulun
/funding/spreadendpoint'inemin_spreadile istek yapın (her API planı) vespread_pct'ye göre sıralayın.Oranları ve ödemeleri kontrol edin
/funding/ratesendpoint'inecoinile istek yapın: iki borsadakiinterval,next_payoutvefunding_8h_pct. Pozisyon ödeme anında açık olmalıdır.Geçmişe bakın
Pro ve Max'te
/funding/analytics/summaryendpoint'inecoinile istek yapın: 7d ve 30d içinsum,apr,covveflips, oran farkının korunup korunmadığını gösterir.Kombinasyonu bütün olarak değerlendirin
/funding/analytics/topiçindenet,apr_capital,win_rate,max_ddve güncelprice_divdeğerlerini karşılaştırın.Pozisyonları kendiniz açın
trade_urlbağlantıları borsa terminallerine götürür; kombinasyonun komisyonlu fiyatını spread hesaplayıcıda hesaplayın.
Sorular ve cevaplar
Fonlama oranı 8 saate nasıl normalize edilir?
Aralık başına oranı 8 ile çarpıp aralığın saat cinsinden uzunluğuna bölün. /funding/rates bunu funding_8h_pct alanında sizin için yapar.
Fonlama oranı geçmişini nereden alırım?
/funding/analytics/recent 7 gündeki tüm ödemeleri, /funding/analytics/daily bir yıllık günlük toplamları, /funding/analytics/summary ise dönem toplamlarını içerir. Üçü de API Pro ve Max planlarındadır.
Tam analitik bölümü neden 429 döndürüyor?
coin olmadan yapılan tam indirmeler sınırlıdır: summary ve recent anahtar başına 60 saniyede bir, daily 300 saniyede bir. Coin dilimleri ve If-None-Match için 304 yanıtları sınırlanmaz.