Genesis API Dokümantasyonu
Entegrasyon için gereken her şey: kimlik doğrulama, limitler, endpoint'ler ve yanıt şemaları.
Fonlama analitiği
13 borsada geçmiş gerçekleşmiş fonlama analitiği — dört endpoint'lik bir bölüm. Tüm oranlar uzlaşma dönemi başına yüzdedir, zaman damgaları UTC epoch saniyesidir. Pro ve Max'te mevcut; diğer planlar 403 plan_restricted alır. Tam bölümler büyüktür — coin parametresini ve If-None-Match başlığını kullanın (ETag, generated_at'i izler). coin olmadan tam bölüm indirmeleri sınırlıdır: summary ve recent — 60 saniyede bir, daily — anahtar başına 300 saniyede bir; 304 yanıtları ve coin istekleri sınırsızdır.
/v1/funding/analytics/summaryAnahtar yalnızca tarayıcınızda saklanır ve API dışında hiçbir yere gönderilmez.
Anahtarınızı yapıştırıp istek gönderin — kısaltılmış bir yanıt göstereceğiz.
Analitik: özet
Her coin×borsa çifti için geçmiş gerçekleşmiş fonlama özeti: 1 günden bir yıla kadar 7 dönemde birikmiş toplamlar, ortalama 8s oranlar, APR ve kapsam. Pro ve Max'te mevcut. Tam bölüm ~600 KB gzip'tir — tek bir coin için coin parametresini kullanın; yoklarken If-None-Match iletin (ETag yaklaşık 15 dakikada bir değişir).
https://api.genesisarbitrage.com/v1/funding/analytics/summarySorgu parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
coin | string | Yalnızca tek bir coin için dilim döndür (önerilir: tam bölüm büyüktür) |
Örnek yanıt
{
"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 }
}Yanıt alanları
| Alan | Tür | Açıklama |
|---|---|---|
metric_order | string[] | m dizisi içindeki metrik sırası: sum, avg8h, apr, n, pos, neg, zero, min, max, cov |
periods | string[] | Mevcut dönemler 1d…365d; hiç veri yoksa dönem m içinde bulunmaz |
coins.{c}.canon / mult | string / number | Varyantları birleştirmek için kanonik coin adı (1000PEPE→PEPE) ve kontrat çarpanı; mult oranlara asla uygulanmaz |
…exchanges.{ex}.interval_h | number | Saat cinsinden uzlaşma aralığı: CEX'te 8/4, Hyper ve Lighter'da 1 |
…exchanges.{ex}.data_since | number | Verinin başladığı yer (epoch saniyesi); bu tarihten önce sıfır çizmeyin |
…exchanges.{ex}.last8h | number | null | 8s eşdeğerinde en son gerçek oran — “şimdi ve norm” karşılaştırması |
…exchanges.{ex}.m.{period} | (number | null)[14] | metric_order sırasında dönem metrik dizisi (14 alan: sum, avg8h, apr, n, pos, neg, zero, min, max, cov, med8h, pos_streak, neg_streak, flips); 10–13 indeksleri 1d ve 3d dönemlerinde null'dır |
m[9] (cov) | number 0..1 | Dönem kapsamı 0..1; 0.9'un altında veri dönemin bir kısmını kapsar — arayüzde bunu işaretleyin |
Analitik: 7g ödemeler
1D/3D/7D grafikleri için son 7 günün her fonlama ödemesi. Oranlar uzlaşma dönemi başına yüzdedir, zaman damgaları UTC epoch saniyesidir. Pro ve Max; tam bölüm ~1 MB gzip'tir — coin önerilir.
https://api.genesisarbitrage.com/v1/funding/analytics/recentSorgu parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
coin | string | Yalnızca tek bir coin için dilim döndür (önerilir: tam bölüm büyüktür) |
Örnek yanıt
{
"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 }
}Yanıt alanları
| Alan | Tür | Açıklama |
|---|---|---|
days | number | Bölümün gün cinsinden veri derinliği |
coins.{c}.{ex}.i | number | Saat cinsinden uzlaşma aralığı: CEX'te 8/4, Hyper ve Lighter'da 1 |
coins.{c}.{ex}.s | string | Nokta dizesi ts:rate;ts:rate;… zamana göre artan; ts epoch saniyesidir |
Analitik: 1y günlük
1M/3M/1Y grafikleri için 365 günlük günlük fonlama toplamları. Geçmiş dolduğunda bölüm büyüktür (~12 MB gzip) — coin ve If-None-Match kullanın; saatlik yeniden oluşturulur.
https://api.genesisarbitrage.com/v1/funding/analytics/dailySorgu parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
coin | string | Yalnızca tek bir coin için dilim döndür (önerilir: tam bölüm büyüktür) |
Örnek yanıt
{
"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 }
}Yanıt alanları
| Alan | Tür | Açıklama |
|---|---|---|
days | number | Bölümün gün cinsinden veri derinliği |
coins.{c}.{ex} | string | Gün dizesi day_ts:sum:pos:neg;… — UTC gece yarısı, gün toplamı, pozitif ve negatif uzlaşma sayıları |
Analitik: tarayıcı
Hazır tarayıcı: birikmiş fonlamaya göre ilk 50 coin×borsa çifti ve dönem başına ilk 50 borsa kombinasyonu (short/long). Kombinasyon bacakları her zaman farklı borsalardadır, kapsam ≥0.9. gross komisyonlardan önce, net dört işlemin taker komisyonlarından sonradır; bacaklar arasındaki fiyat farkı dahil değildir. Pro ve Max.
https://api.genesisarbitrage.com/v1/funding/analytics/topÖrnek yanıt
{
"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 }
}Yanıt alanları
| Alan | Tür | Açıklama |
|---|---|---|
taker_fees | object | Komisyonlar hesaplanırken uygulanan taker komisyon tablosu |
periods.{p}.by_net_apr / by_stable / by_live | array | by_net_apr — net getiriye göre sıralı; by_stable — win_rate ≥ 0.7 ve düşüş brütün yarısından az; by_live — live_8h > 0 ve trend_1d > 0; by_sum_pos / by_sum_neg — tek borsa listeleri |
bundle.gross / fees / net | number | net = brüt − komisyonlar: kombinasyonun dört işlem komisyonundan sonraki sonucu; net ≤ 0 olan satırlar listelerde asla yer almaz |
bundle.apr_net / apr_capital | number | apr_net — bir bacağın nominaline göre yıllıklandırılmış; apr_capital = apr_net / 2 — yatırılan sermayeye göre yıllıklandırılmış (her iki bacak da teminat gerektirir) |
bundle.win_rate / max_dd / worst_streak / risk_days | number | win_rate — kârlı günlerin payı (0..1), max_dd — kümülatif eğrinin maksimum düşüşü, worst_streak — en uzun zararlı gün serisi, risk_days — riskin ölçüldüğü gün sayısı (en fazla 90) |
bundle.live_8h / trend_1d / trend_7d / price_div | number | null | live_8h — 8s eşdeğerinde güncel oran farkı; trend_1d / trend_7d — son gün ve hafta için brüt spread; price_div — güncel vadeli işlem fiyat sapması (fiyatlar yoksa null) |
bundle.short_sym / long_sym | string | Borsalardaki gerçek bacak ticker'ları — farklı olabilir (PEPE ve 1000PEPE) |
periods.{p}.by_sum_pos / by_sum_neg | array | Birikmiş fonlamaya göre ilk 50 (yalnızca cov ≥ 0.5) |