Genesis Arbitrage

Genesis Arbitrage · · 15 menit baca

API funding rate: rate semua exchange dalam satu request, plus riwayat funding yang telah diselesaikan

Ringkasan

  • API funding rate harus mengembalikan, untuk setiap exchange, rate per interval, interval itu sendiri, waktu funding berikutnya, rate dalam hitungan 8 jam, dan harga futures.
  • Binance, Bybit, OKX, dan Hyperliquid masing-masing punya endpoint, satuan, dan cara melaporkan interval sendiri. Genesis API /funding/rates mengembalikan rate semua exchange dalam satu request GET, dalam persen dan dinormalisasi ke 8 jam.
  • Riwayat funding yang telah diselesaikan di 13 exchange — total, rate rata-rata, APR, total harian selama setahun, dan screener bundel dengan net setelah biaya — ada di /funding/analytics/* pada paket Pro dan Max.

Untuk futures perpetual, API funding rate mengembalikan rate per exchange: rate per interval, interval itu sendiri, dan waktu funding berikutnya, serta pada versi yang lebih lengkap, riwayat funding yang telah diselesaikan. Setiap exchange punya API sendiri dengan path, satuan, dan interval sendiri. Karena itu, untuk membandingkannya Anda mengumpulkan rate dalam satu tabel, mengubahnya ke persen, dan menormalisasinya ke satu periode, biasanya 8 jam.

Apa yang harus dikembalikan API funding rate

Rate tanpa intervalnya tidak berarti apa-apa: 0,02% setiap 4 jam dan 0,02% setiap 8 jam berbeda dua kali lipat. Karena itu API funding rate kripto yang berguna mengembalikan lima nilai untuk setiap pasangan koin–exchange.

Yang Anda perlukanMengapaField /funding/rates
Rate per intervalBerapa payout berikutnyafunding_pct
Interval fundingTanpa ini rate tidak bisa dibandingkaninterval
Waktu funding berikutnyaPosisi harus sudah terbuka sebelum itunext_payout
Rate per 8 jamMembandingkan exchange dengan interval berbedafunding_8h_pct
Harga futuresSelisih harga antar leg menggeser entry Andaprice

Pembayarannya adalah ukuran posisi dikali rate: posisi $10.000 pada 0,01% menerima atau membayar $1 per settlement.

Mengapa interval exchange berbeda dan cara menormalisasi rate ke 8 jam

Setiap exchange menentukan sendiri seberapa sering funding diselesaikan dan dapat mengubah interval untuk kontrak tertentu. Dalam analitik Genesis API, interval CEX adalah 8 dan 4 jam, sedangkan Hyperliquid dan Lighter melakukan settlement setiap jam. Hyperliquid menghitung rate sebagai rate 8 jam dan membayarkan seperdelapannya setiap jam, seperti dijelaskan di aturan funding Hyperliquid.

Pada contoh di dokumentasi Genesis API, MEXC mengenakan 0,02% untuk TON setiap 4 jam: 0,02 × 8 / 4 = 0,04% per 8 jam. Contoh hipotetis dengan interval per jam: exchange A membayar 0,004% setiap jam, exchange B membayar 0,02% setiap 8 jam. Menurut angka mentah, A membayar seperlima, tetapi dalam 8 jam totalnya 0,004 × 8 / 1 = 0,032% berbanding 0,02%, yaitu 1,6 kali lebih besar.

Normalisasi mengasumsikan rate bertahan sepanjang periode, sedangkan rate per jam bisa berubah pada settlement berikutnya. Hanya riwayat yang menunjukkan apa yang benar-benar dibayarkan.

APR dihitung dari rate 8 jam: tiga settlement sehari, 1.095 setahun. Untuk exchange A itu 0,032 × 3 × 365 = 35,04% per tahun, selama rate bertahan.

API funding rate di exchange: Binance, Bybit, OKX, dan Hyperliquid

Setiap exchange besar punya API funding rate sendiri: path, field, dan cara melaporkan interval yang berbeda.

ExchangeRate saat iniRiwayatInterval
BinanceGET /fapi/v1/premiumIndexGET /fapi/v1/fundingRateGET /fapi/v1/fundingInfo
BybitGET /v5/market/tickersGET /v5/market/funding/historyfield fundingIntervalHour
OKXGET /api/v5/public/funding-rateGET /api/v5/public/funding-rate-historydari fundingTime dan nextFundingTime
HyperliquidPOST /info, metaAndAssetCtxsPOST /info, fundingHistorysetiap jam

API funding rate Binance mengembalikan rate dan waktu funding berikutnya di field lastFundingRate dan nextFundingTime pada premiumIndex (dokumentasi Binance), dan riwayat funding rate Binance berasal dari fundingRate, yang menerima startTime dan endTime (riwayat funding rate). fundingInfo mengembalikan interval hanya untuk kontrak yang interval atau batas rate-nya telah disesuaikan exchange (deskripsi endpoint).

Bybit mengembalikan fundingRate, nextFundingTime, dan fundingIntervalHour dalam satu respons tickers dengan category=linear (Bybit tickers), dan request riwayatnya mewajibkan symbol (riwayat funding Bybit). Seperti ditegaskan dokumentasinya, setiap kontrak punya interval sendiri.

Untuk OKX, dokumentasi menyarankan menghitung interval kontrak dari selisih antara nextFundingTime dan fundingTime (dokumentasi OKX).

Hyperliquid menerima semua query data di POST https://api.hyperliquid.xyz/info, dan body JSON menentukan apa yang dikembalikan: {"type": "metaAndAssetCtxs"} mengembalikan funding saat ini per aset, {"type": "fundingHistory", "coin": "ETH", "startTime": …} mengembalikan riwayat rate (dokumentasi Hyperliquid).

Untuk menggabungkan exchange-exchange ini ke dalam satu tabel, kode Anda harus:

Semua exchange dalam satu request: /funding/rates

GET /funding/rates mengembalikan, untuk setiap koin, daftar exchange beserta rate saat ini: Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, HTX, Hyperliquid, dan exchange lain yang dicakup Genesis Arbitrage, total 1000+ koin. Filter coin dan exchange (dipisah koma untuk beberapa exchange) bersifat opsional; tanpa filter Anda mendapat seluruh set.

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

Ini adalah satu elemen dari array data di dalam envelope yang dipakai semua respons Genesis API: success, data, meta. Rate dalam persen, next_payout adalah waktu payout dalam format JJ:MM UTC, nilai kosong berupa null, dan Hyperliquid muncul sebagai Hyper. Semua field dan form Try it ada di bagian dokumentasi Funding rate.

/funding/rates dan /funding/spread tersedia di setiap paket, mulai dari Trial seharga $20 per bulan: 500 ribu panggilan, 1 request per detik, kesegaran data 60 detik (harga Genesis API).

Spread funding: /funding/spread

Spread funding adalah selisih antara rate tertinggi dan terendah sebuah koin di berbagai exchange setelah dinormalisasi ke 8 jam. Short dibuka di tempat rate lebih tinggi dan long di tempat rate lebih rendah: short menerima rate exchange-nya, long membayar rate miliknya (atau menerima jika rate itu negatif), dan selisihnya yang tersisa.

GET /funding/spread mengembalikan, untuk setiap koin, pasangan exchange terbaik di best: exchange_1 dan exchange_2, rate masing-masing per interval sendiri (funding_1_pct, funding_2_pct), interval, waktu payout, dan tautan terminal. Spread pasangan itu ada di spread_pct, exchange lainnya ada di others, dan filternya adalah coin dan min_spread (dokumentasi Spread funding). Interval sebuah pasangan sering berbeda, seperti 1h dan 8h untuk BTC pada contoh di dokumentasi, jadi bandingkan rate pasangan secara manual hanya setelah menormalisasinya ke 8 jam.

Python: 10 spread funding teratas, dianualisasi

Skrip mengambil seluruh set /funding/rates dan, untuk setiap koin, mencari exchange dengan funding_8h_pct tertinggi dan terendah: selisihnya adalah spread 8 jam, dianualisasi sebagai spread × 3 × 365. Pada 429 dan 503 skrip menunggu Retry-After detik, tetapi tidak lebih dari semenit: saat kuota bulanan habis, Retry-After berlangsung sampai kuota direset.

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}%")

Angka anualisasi di sini dihitung dari notional satu leg. Kedua leg membutuhkan dana, jadi pada total modal tanpa leverage hasilnya setengahnya, seperti field analitik apr_capital. Contoh hipotetis: short di satu exchange dengan 0,05% per 8 jam, long di exchange lain dengan 0,01%. Spread-nya 0,05 − 0,01 = 0,04%, dianualisasi 0,04 × 3 × 365 = 43,8% per leg dan 21,9% dari modal.

Biaya tidak termasuk. Contoh hipotetis: biaya taker 0,05% pada masing-masing empat transaksi (membuka dan menutup kedua leg) berjumlah 4 × 0,05 = 0,2% dari notional satu leg. Spread 0,04% menutup biaya itu dalam 0,2 / 0,04 = 5 settlement, atau 40 jam, jika rate tetap.

Hanya respons 200 yang dihitung terhadap kuota. Pada monitor, lakukan polling tidak lebih sering dari sekali per meta.freshness_sec detik dan kirim ETag sebelumnya di If-None-Match: set penuh yang tidak berubah kembali sebagai 304 yang tidak ditagih. Selengkapnya ada di panduan limit dan di pelajaran 4 kursus API kripto, yang membangun monitor spread dan funding dengan Python.

Riwayat funding yang telah diselesaikan: /funding/analytics/*

Rate saat ini menunjukkan settlement berikutnya; riwayat menunjukkan apa yang benar-benar dibayarkan. Riwayat berasal dari empat endpoint analitik: 13 exchange, rate dalam persen per periode settlement, timestamp dalam epoch detik UTC. Endpoint ini ada di paket Pro ($100 per bulan) dan Max ($200); Trial dan Start mendapat 403 plan_restricted.

EndpointIsiBagian penuh
/funding/analytics/summaryTotal, rata-rata rate 8 jam, APR, dan cakupan untuk 7 periode, dari 1 hari hingga setahun~600 KB gzip
/funding/analytics/recentSetiap payout selama 7 hari terakhir~1 MB gzip
/funding/analytics/dailyTotal harian selama 365 harihingga ~12 MB gzip
/funding/analytics/top50 teratas pasangan koin×exchange dan 50 teratas bundel short/long per periode—

Unduhan penuh tanpa coin dibatasi: summary dan recent sekali per 60 detik, daily sekali per 300 detik per key; request sebelum jendela berakhir mendapat 429 dengan Retry-After. Potongan coin dan respons 304 tidak dibatasi, jadi ambil riwayat satu koin seperti ini:

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

Di summary, setiap pasangan koin×exchange membawa interval interval_h, awal data data_since, rate 8 jam terbaru last8h untuk perbandingan «sekarang vs normal», dan array m berisi 14 metrik per periode: sum, avg8h, apr, cov, flips, dan lainnya. Contoh di dokumentasi: BTC di Binance selama 7 hari, 21 settlement positif, avg8h 0,006298%, apr 0,006298 × 3 × 365 ≈ 6,896%. Cara mem-parsing m, recent, dan daily dibahas di panduan endpoint funding, dan field-nya di bagian dokumentasi Analitik funding.

Screener bundel top

/funding/analytics/top adalah screener siap pakai tanpa parameter. Leg bundel di dalamnya selalu berada di exchange berbeda dengan cakupan minimal 0,9, dan bundel dengan net ≤ 0 tidak pernah masuk daftar.

gross adalah funding bruto bundel untuk periode itu, fees adalah biaya empat transaksi dari tabel taker_fees, dan net = gross − fees. apr_net dianualisasi dari notional satu leg, apr_capital separuhnya, dari modal kedua leg. win_rate adalah porsi hari yang menguntungkan, max_dd drawdown terbesar, dan price_div selisih harga saat ini antar leg, yang tidak dihitung dalam net.

Pada contoh di dokumentasi, bundel PEPE (short di HTX, long di Hyperliquid dengan ticker 1000PEPE) menghasilkan gross 1,51504% dengan fees 0,19 selama 7 hari. Jadi net = 1,51504 − 0,19 = 1,32504%, apr_net 69,09%, dan apr_capital 34,55%. Daftar siap pakai: by_net_apr berdasarkan hasil bersih, by_stable untuk bundel yang stabil, by_live untuk yang sedang berjalan sekarang.

Funding rate sebagai indikator pasar

Saat rate positif, long dengan leverage membayar short; saat negatif, sebaliknya. Rate positif kecil itu normal (Hyperliquid menetapkan komponen bunga 0,01% per 8 jam), dan rate menjadi sinyal ketika bergerak jauh dari level biasanya.

Baca rate tinggi bersama open interest: ketika keduanya naik, banyak posisi ber-leverage menumpuk di satu sisi, dan pergerakan melawan mereka memicu rentetan likuidasi. /market/open-interest mengembalikan open interest per exchange (bagian dokumentasi). Selengkapnya di Funding rate sebagai indikator pasar.

Risiko arbitrase funding

Bundel short/long di dua exchange nyaris tidak bergantung pada harga, tetapi Anda tetap bisa rugi:

Tanpa kode, rate yang sama ada di tabel Arbitrase Funding (panduan), kalkulator spread menghitung bundel beserta biayanya, dan ikhtisar API kripto membandingkan API data pasar secara umum.

Tanya jawab

Di mana saya bisa mendapatkan riwayat funding rate?

Exchange menyimpan riwayat dalam format masing-masing: GET /fapi/v1/fundingRate di Binance, GET /v5/market/funding/history di Bybit, tipe fundingHistory di Hyperliquid. Genesis API mengembalikan riwayat 13 exchange dalam satu format: /funding/analytics/recent untuk payout 7 hari, /funding/analytics/daily untuk total harian selama setahun, dan /funding/analytics/summary untuk total per periode, pada paket Pro dan Max.

Mengapa funding rate berbeda antar exchange?

Setiap exchange punya trader, likuiditas, rumus rate, dan batas sendiri, sehingga ketidakseimbangan posisi menumpuk secara berbeda. Interval juga berbeda: 8 atau 4 jam di CEX, setiap jam di Hyperliquid. Bandingkan rate setelah menormalisasinya ke satu periode; di Genesis API itu adalah field funding_8h_pct.

Seberapa sering funding rate diperbarui di API?

Rate saat ini di exchange berubah sampai settlement; rate yang telah diselesaikan dikunci dan masuk ke riwayat. Kesegaran data Genesis API adalah 60 detik di Trial, 30 detik di Start, 10 detik di Pro, dan 5 detik di Max; ETag summary analitik berubah sekitar setiap 15 menit, dan total harian dibangun ulang setiap jam.

Apakah ada API funding rate gratis?

Genesis API tidak punya paket gratis: funding rate dan spread ada di Trial seharga $20 per bulan, riwayat di Pro seharga $100 dan Max seharga $200. Di situs, funding rate dan spread terlihat tanpa paket di Arbitrase Funding.