Genesis Arbitrage

Genesis Arbitrage · · 11 dk okuma

Genesis API fonlama endpoint'leri: oranlar, spread ve fonlama geçmişi analitiği

Kısaca

  • /funding/rates ve /funding/spread her 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: coin dilimi alın veya isteği If-None-Match ile 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

EndpointDöndürürAPI planları
/funding/ratesHer coin için tüm borsaların oranlarıTrial, Start, Pro, Max
/funding/spreadSpread'e göre en iyi borsa çifti ve diğer borsalarTrial, Start, Pro, Max
/funding/analytics/summary1 günden bir yıla kadar dönemlerin özetiPro, Max
/funding/analytics/recent7 gündeki tüm ödemelerPro, Max
/funding/analytics/daily365 günlük günlük toplamlarPro, 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"
    }
  ]
}
AlanAnlamı
funding_pctÖdeme aralığı başına oran, %
funding_8h_pct8 saate normalize edilmiş oran, %
intervalÖdeme aralığı, örn. 8h; null — veri yok
next_payoutSonraki ödeme zamanı, SS:DD UTC; null — veri yok
price, trade_urlFiyat 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İçerikTam bölümcoin olmadan en fazla
/funding/analytics/summary7 dönem için toplamlar, ortalama oranlar, APR ve kapsam~600 KB gzip60 sn'de bir
/funding/analytics/recent7 gündeki tüm ödemeler~1 MB gzip60 sn'de bir
/funding/analytics/daily365 günlük günlük toplamlar~12 MB gzip'e kadar300 sn'de bir
/funding/analytics/topDö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İndeksAnlamı
sum0Dönem boyunca birikmiş toplam, %
avg8h18 saat cinsinden ortalama oran, %
apr2Yıllıklandırılmış, %
n3Ödeme sayısı
pos, neg, zero4–6Pozitif, negatif ve sıfır ödemeler
min, max7–8En küçük ve en büyük ödeme, %
cov90'dan 1'e dönem kapsamı
med8h108 saat cinsinden medyan, %
pos_streak, neg_streak11–12Art arda pozitif ve negatif gün sayısı
flips13İş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ı:

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.

Kombinasyon alanıAnlamı
gross, fees, netBrüt fonlama, taker_fees'e göre dört işlemin komisyonu ve net = gross − fees
apr_net, apr_capitalBir bacağın nominaline göre yıllıklandırılmış getiri ve iki bacağın sermayesine göre apr_net / 2
win_rate, max_ddKârlı günlerin payı (0..1) ve kümülatif sonucun maksimum düşüşü
worst_streak, risk_daysZararlı günlerin en uzun serisi ve riskin ölçüldüğü gün sayısı, en fazla 90
live_8h, trend_1d, trend_7d8 saat üzerinden güncel oran farkı ile son gün ve son haftanın brüt spread'i
price_divBacaklar arasındaki güncel fiyat farkı; fiyatlar yoksa null
short_sym, long_symBorsalardaki 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

  1. Adayları bulun

    /funding/spread endpoint'ine min_spread ile istek yapın (her API planı) ve spread_pct'ye göre sıralayın.

  2. Oranları ve ödemeleri kontrol edin

    /funding/rates endpoint'ine coin ile istek yapın: iki borsadaki interval, next_payout ve funding_8h_pct. Pozisyon ödeme anında açık olmalıdır.

  3. Geçmişe bakın

    Pro ve Max'te /funding/analytics/summary endpoint'ine coin ile istek yapın: 7d ve 30d için sum, apr, cov ve flips, oran farkının korunup korunmadığını gösterir.

  4. Kombinasyonu bütün olarak değerlendirin

    /funding/analytics/top içinde net, apr_capital, win_rate, max_dd ve güncel price_div değerlerini karşılaştırın.

  5. Pozisyonları kendiniz açın

    trade_url bağ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.