Genesis Arbitrage

Genesis Arbitrage · · 14 dk okuma

Fonlama oranı API: tüm borsaların oranları tek istekte ve gerçekleşmiş fonlama geçmişi

Kısaca

  • Bir fonlama oranı API'si her borsa için aralık başına oranı, aralığın kendisini, sonraki fonlama zamanını, 8 saate çevrilmiş oranı ve vadeli işlem fiyatını döndürmelidir.
  • Binance, Bybit, OKX ve Hyperliquid'in her birinin kendi endpoint'leri, birimleri ve aralığı bildirme yöntemi var. Genesis API /funding/rates tüm borsaların oranlarını tek bir GET isteğinde, yüzde olarak ve 8 saate normalleştirilmiş biçimde döndürür.
  • 13 borsada gerçekleşmiş fonlama geçmişi — toplamlar, ortalama oranlar, APR, bir yıllık günlük toplamlar ve ücretlerden sonra net değeri veren bundle tarayıcısı — Pro ve Max planlarında /funding/analytics/* altındadır.

Fonlama oranı API'si, sürekli vadeli işlem fonlama oranlarını borsa bazında döndürür: aralık başına oran, aralığın kendisi ve sonraki fonlama zamanı; daha kapsamlı sürümde ise gerçekleşmiş fonlama geçmişi. Her borsanın kendi API'si, kendi yolları, birimleri ve aralıkları vardır. Bu yüzden karşılaştırmak için oranları tek tabloda toplar, yüzdeye çevirir ve çoğunlukla 8 saat olan tek bir döneme normalleştirirsiniz.

Bir fonlama oranı API'si ne döndürmeli

Aralığı olmayan bir oran bir şey anlatmaz: her 4 saatte %0,02 ile her 8 saatte %0,02 arasında iki kat fark vardır. Bu yüzden işe yarar bir kripto fonlama oranı API'si her coin–borsa çifti için beş değer döndürür.

Neye ihtiyacınız varNeden/funding/rates alanı
Aralık başına oranBir sonraki ödemenin ne olacağıfunding_pct
Fonlama aralığıBu olmadan oranlar karşılaştırılamazinterval
Sonraki fonlama zamanıPozisyonun o ana kadar açık olması gerekirnext_payout
8 saatlik oranFarklı aralıklı borsaları karşılaştırmak içinfunding_8h_pct
Vadeli işlem fiyatıBacaklar arasındaki fiyat farkı girişi etkilerprice

Ödeme, pozisyon büyüklüğü çarpı orandır: %0,01 oranında 10.000 $'lık bir pozisyon her fonlamada 1 $ alır veya öder.

Borsa aralıkları neden farklıdır ve oran 8 saate nasıl normalleştirilir

Her borsa fonlamayı ne sıklıkla gerçekleştireceğine kendisi karar verir ve tek bir sözleşme için aralığı değiştirebilir. Genesis API analitiğinde CEX aralıkları 8 ve 4 saattir; Hyperliquid ve Lighter ise her saat fonlama yapar. Hyperliquid oranı 8 saatlik oran olarak hesaplar ve her saat bunun sekizde birini öder; bu, Hyperliquid fonlama kurallarında anlatılır.

Genesis API belgelerindeki örnekte MEXC, TON için her 4 saatte %0,02 uygular: 0,02 × 8 / 4 = 8 saatte %0,04. Saatlik aralıkla varsayımsal bir örnek: A borsası her saat %0,004, B borsası her 8 saatte %0,02 öder. Ham sayılara göre A beş kat az öder, ama 8 saatte 0,004 × 8 / 1 = %0,032 eder; B'nin %0,02'sinden 1,6 kat fazladır.

Normalleştirme, oranın tüm dönem boyunca sabit kalacağını varsayar; saatlik oran ise bir sonraki fonlamada hemen değişebilir. Gerçekte neyin ödendiğini yalnızca geçmiş gösterir.

APR 8 saatlik orandan hesaplanır: günde üç fonlama, yılda 1.095. A borsası için bu, oran sabit kaldığı sürece 0,032 × 3 × 365 = yıllık %35,04 eder.

Borsaların fonlama oranı API'leri: Binance, Bybit, OKX ve Hyperliquid

Her büyük borsanın kendi fonlama oranı API'si vardır: kendi yolları, alanları ve aralığı bildirme yöntemi.

BorsaGüncel oranGeçmişAralık
BinanceGET /fapi/v1/premiumIndexGET /fapi/v1/fundingRateGET /fapi/v1/fundingInfo
BybitGET /v5/market/tickersGET /v5/market/funding/historyfundingIntervalHour alanı
OKXGET /api/v5/public/funding-rateGET /api/v5/public/funding-rate-historyfundingTime ve nextFundingTime değerlerinden
HyperliquidPOST /info, metaAndAssetCtxsPOST /info, fundingHistoryher saat

Binance fonlama oranı API'si, oranı ve sonraki fonlama zamanını premiumIndex yanıtındaki lastFundingRate ve nextFundingTime alanlarında döndürür (Binance belgeleri); Binance geçmiş fonlama oranları ise startTime ve endTime parametrelerini alan fundingRate ile alınır (fonlama oranı geçmişi). fundingInfo, aralığı yalnızca borsanın aralığını veya oran sınırını ayarladığı sözleşmeler için döndürür (endpoint açıklaması).

Bybit, category=linear ile tek bir tickers yanıtında fundingRate, nextFundingTime ve fundingIntervalHour döndürür (Bybit tickers); geçmiş isteğinde symbol zorunludur (Bybit fonlama geçmişi). Belgelerin belirttiği gibi, her sözleşmenin kendi aralığı vardır.

OKX için belgeler, sözleşmenin aralığının nextFundingTime ile fundingTime arasındaki farktan hesaplanmasını önerir (OKX belgeleri).

Hyperliquid tüm veri sorgularını POST https://api.hyperliquid.xyz/info adresinde kabul eder ve dönen veriyi JSON gövdesi belirler: {"type": "metaAndAssetCtxs"} varlık başına güncel funding değerini, {"type": "fundingHistory", "coin": "ETH", "startTime": …} oran geçmişini döndürür (Hyperliquid belgeleri).

Bu borsaları tek tabloda birleştirmek için kodunuzun şunları yapması gerekir:

Tüm borsalar tek istekte: /funding/rates

GET /funding/rates, her coin için güncel oranlarla borsa listesini döndürür: Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, HTX, Hyperliquid ve Genesis Arbitrage'ın kapsadığı diğer borsalar, toplam 1000'den fazla coin. coin ve exchange filtreleri (birden fazla borsa için virgülle ayrılır) isteğe bağlıdır; bunlar olmadan tüm set gelir.

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"
    }
  ]
}

Bu, tüm Genesis API yanıtlarının paylaştığı zarfın (success, data, meta) içindeki data dizisinin tek bir öğesidir. Oranlar yüzde olarak verilir, next_payout ödeme zamanıdır (SS:DD, UTC), boş değerler null olur ve Hyperliquid Hyper olarak görünür. Tüm alanlar ve Try it formu Fonlama oranları belge bölümündedir.

/funding/rates ve /funding/spread her planda vardır; en düşük plan ayda 20 $'lık Trial'dır: 500 bin çağrı, saniyede 1 istek, 60 sn veri tazeliği (Genesis API fiyatları).

Fonlama spread'i: /funding/spread

Fonlama spread'i, 8 saate normalleştirildikten sonra bir coin için borsalar arasındaki en yüksek ve en düşük oran arasındaki farktır. Short oranın yüksek olduğu yere, long düşük olduğu yere açılır: short kendi borsasının oranını alır, long kendi oranını öder (oran negatifse alır) ve geriye fark kalır.

GET /funding/spread, her coin için best içinde en iyi borsa çiftini döndürür: exchange_1 ve exchange_2, bunların kendi aralıklarındaki oranları (funding_1_pct, funding_2_pct), aralıklar, ödeme zamanları ve terminal bağlantıları. Çiftin spread'i spread_pct içindedir, diğer borsalar others içindedir, filtreler coin ve min_spread'dir (Fonlama spread'i belgeleri). Bir çiftin aralıkları çoğu zaman farklıdır; belge örneğindeki BTC için 1h ve 8h gibi. Bu yüzden çiftin oranlarını elle karşılaştırmayı ancak 8 saate normalleştirdikten sonra yapın.

Python: yıllıklandırılmış ilk 10 fonlama spread'i

Betik /funding/rates setinin tamamını alır ve her coin için en yüksek ve en düşük funding_8h_pct değerine sahip borsaları bulur: fark 8 saatlik spread'dir ve spread × 3 × 365 olarak yıllıklandırılır. 429 ve 503 durumunda Retry-After saniye bekler, ancak bir dakikadan fazla değil: aylık kota bittiğinde Retry-After kotanın sıfırlanmasına kadar sürer.

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 or 503: wait Retry-After, but no longer than a minute
        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"])  # short leg
    long_ = min(ex, key=lambda e: e["funding_8h_pct"])  # long leg
    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  # simple APR on one leg's notional
    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}%")

Buradaki yıllıklandırılmış değer tek bacağın nominal tutarı üzerindendir. İki bacak da para gerektirir; bu yüzden kaldıraçsız toplam sermaye üzerinden getiri yarı yarıyadır, tıpkı analitikteki apr_capital alanı gibi. Varsayımsal bir örnek: bir borsada 8 saatte %0,05 ile short, bir diğerinde %0,01 ile long. Spread 0,05 − 0,01 = %0,04, yıllıklandırılmış 0,04 × 3 × 365 = bacak başına %43,8 ve sermaye üzerinden %21,9'dur.

Ücretler dahil değildir. Varsayımsal bir örnek: dört işlemin (iki bacağı açmak ve kapatmak) her birinde %0,05 taker ücreti, bir bacağın nominal tutarının 4 × 0,05 = %0,2'sini eder. %0,04'lük spread bunu, oranlar yerinde kalırsa 0,2 / 0,04 = 5 fonlamada, yani 40 saatte geri kazandırır.

Kotaya yalnızca 200 yanıtı sayılır. Bir izleyicide meta.freshness_sec saniyede bir defadan sık sorgulamayın ve önceki ETag değerini If-None-Match içinde gönderin: değişmeyen tam set, ücretlendirilmeyen bir 304 olarak döner. Daha fazlası limit rehberinde ve Python'da spread ve fonlama izleyicisi kuran kripto API kursunun 4. dersinde var.

Gerçekleşmiş fonlama geçmişi: /funding/analytics/*

Güncel oran bir sonraki fonlamayı gösterir; geçmiş ise gerçekte neyin ödendiğini. Geçmiş dört analitik endpoint'inden gelir: 13 borsa, oranlar fonlama dönemi başına yüzde olarak, zaman damgaları epoch saniye cinsinden UTC. Bunlar Pro (ayda 100 $) ve Max (200 $) planlarındadır; Trial ve Start 403 plan_restricted alır.

EndpointİçerikTam bölüm
/funding/analytics/summary7 dönem için toplamlar, ortalama 8 saatlik oranlar, APR ve kapsam; 1 günden bir yıla~600 KB gzip
/funding/analytics/recentSon 7 gündeki her ödeme~1 MB gzip
/funding/analytics/daily365 gün için günlük toplamlar~12 MB gzip'e kadar
/funding/analytics/topDönem başına ilk 50 coin×borsa çifti ve ilk 50 short/long bundle—

coin olmadan tam indirmeler sınırlıdır: summary ve recent anahtar başına 60 saniyede bir, daily 300 saniyede bir; pencere dolmadan yapılan istek Retry-After ile 429 alır. coin dilimleri ve 304 yanıtları sınırlı değildir; bu yüzden bir coinin geçmişini şöyle alın:

curl --compressed -G \
  "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
  -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Summary'de her coin×borsa çifti şunları taşır: interval_h aralığı, data_since veri başlangıcı, «şimdi ile norm» karşılaştırması için son 8 saatlik oran last8h ve dönem başına 14 metriklik bir m dizisi: sum, avg8h, apr, cov, flips ve diğerleri. Belge örneği: Binance'te BTC, 7 günde 21 pozitif fonlama, avg8h %0,006298, apr 0,006298 × 3 × 365 ≈ %6,896. m, recent ve daily verisinin ayrıştırılması fonlama endpoint'leri rehberinde, alanlar ise Fonlama analitiği belge bölümünde anlatılır.

top bundle tarayıcısı

/funding/analytics/top, parametresiz hazır bir tarayıcıdır. İçindeki bundle bacakları her zaman farklı borsalardadır ve kapsamları en az 0,9'dur; net değeri ≤ 0 olan bundle'lar listelere girmez.

gross, bundle'ın dönem için brüt fonlamasıdır, fees, taker_fees tablosundaki dört işlemin ücretidir ve net = gross − fees. apr_net bir bacağın nominal tutarı üzerinden yıllıklandırılır, apr_capital bunun yarısıdır ve iki bacağın sermayesi üzerindendir. win_rate kârlı günlerin payı, max_dd en büyük düşüş, price_div ise bacaklar arasındaki güncel fiyat farkıdır; net bunu hesaba katmaz.

Belge örneğinde PEPE bundle'ı (HTX'te short, Hyperliquid'de 1000PEPE ticker'ıyla long) 7 günde 0,19 fees ile %1,51504 gross üretmiştir. Yani net = 1,51504 − 0,19 = %1,32504, apr_net %69,09 ve apr_capital %34,55'tir. Hazır listeler: net getiriye göre by_net_apr, istikrarlı bundle'lar için by_stable, şu anda çalışanlar için by_live.

Piyasa göstergesi olarak fonlama oranı

Oran pozitifken kaldıraçlı long'lar short'lara öder; negatifken tersi olur. Küçük bir pozitif oran normaldir (Hyperliquid faiz bileşenini 8 saatte %0,01'e sabitler) ve oran olağan seviyesinden belirgin biçimde uzaklaştığında bir sinyale dönüşür.

Yüksek oranı açık pozisyon ile birlikte okuyun: ikisi birlikte yükseldiğinde bir tarafa çok sayıda kaldıraçlı pozisyon yığılmıştır ve onlara karşı bir hareket likidasyon zincirini tetikler. /market/open-interest açık pozisyonu borsa bazında döndürür (belge bölümü). Daha fazlası Piyasa göstergesi olarak fonlama oranı yazısında.

Fonlama arbitrajı riskleri

İki borsa arasındaki short/long bundle fiyata pek bağlı değildir, ama yine de para kaybedebilirsiniz:

Kodsuz olarak aynı oranlar Fonlama Arbitrajı tablosunda (rehber) bulunur, spread hesaplayıcı bir bundle'ı ücretlerle hesaplar, kripto API genel bakışı ise piyasa verisi API'lerini genel olarak karşılaştırır.

Sorular ve cevaplar

Geçmiş fonlama oranlarını nereden alabilirim?

Borsalar geçmişi kendi biçimlerinde tutar: Binance'te GET /fapi/v1/fundingRate, Bybit'te GET /v5/market/funding/history, Hyperliquid'de fundingHistory türü. Genesis API 13 borsanın geçmişini tek biçimde döndürür: 7 günlük ödemeler için /funding/analytics/recent, bir yıllık günlük toplamlar için /funding/analytics/daily ve dönem toplamları için /funding/analytics/summary; Pro ve Max planlarında.

Fonlama oranları borsalar arasında neden farklıdır?

Her borsanın kendi trader'ları, likiditesi, oran formülü ve sınırları vardır; bu yüzden pozisyon dengesizliği farklı birikir. Aralıklar da farklıdır: CEX'te 8 veya 4 saat, Hyperliquid'de her saat. Oranları tek bir döneme normalleştirdikten sonra karşılaştırın; Genesis API'de bu funding_8h_pct alanıdır.

Fonlama oranları API'de ne sıklıkla güncellenir?

Bir borsadaki güncel oran fonlamaya kadar değişir; gerçekleşen oran sabitlenir ve geçmişe girer. Genesis API veri tazeliği Trial'da 60 sn, Start'ta 30 sn, Pro'da 10 sn ve Max'te 5 sn'dir; analitik summary'nin ETag değeri yaklaşık her 15 dakikada değişir, günlük toplamlar saatlik yeniden oluşturulur.

Ücretsiz bir fonlama oranı API'si var mı?

Genesis API'nin ücretsiz planı yoktur: fonlama oranları ve spread ayda 20 $'lık Trial'da, geçmiş ayda 100 $'lık Pro'da ve 200 $'lık Max'tedir. Sitede fonlama oranları ve spread'ler plansız olarak Fonlama Arbitrajı sayfasında görünür.