Endpoint funding Genesis API: rate, spread, dan analitik riwayat funding
Ringkasan
/funding/ratesdan/funding/spreadtersedia di setiap paket API: rate tiap exchange per interval dan per 8 jam, waktu payout berikutnya, serta pasangan exchange terbaik berdasarkan spread.- Analitik funding yang sudah settle adalah empat endpoint
/funding/analytics/…di 13 exchange dengan riwayat hingga satu tahun, tersedia di paket Pro dan Max. - Unduhan penuh summary, recent, dan daily berukuran hingga ~12 MB gzip dan boleh dilakukan sekali per 60–300 detik: ambil irisan
coinatau ulangi request denganIf-None-Match.
API funding rate di Genesis API adalah kumpulan endpoint berisi funding rate futures perpetual di berbagai exchange, pasangan exchange terbaik berdasarkan spread funding, dan riwayat funding yang sudah settle. Rate saat ini dan spread tersedia di setiap paket API; analitik historis 13 exchange ada di paket Pro dan Max. Situs menampilkan data yang sama di Funding Arbitrage, lihat panduan.
Endpoint funding dan paket
| Endpoint | Mengembalikan | Paket API |
|---|---|---|
/funding/rates | Rate semua exchange untuk tiap koin | Trial, Start, Pro, Max |
/funding/spread | Pasangan exchange terbaik berdasarkan spread dan exchange lainnya | Trial, Start, Pro, Max |
/funding/analytics/summary | Ringkasan untuk periode 1 hari hingga satu tahun | Pro, Max |
/funding/analytics/recent | Semua payout selama 7 hari | Pro, Max |
/funding/analytics/daily | Total harian selama 365 hari | Pro, Max |
/funding/analytics/top | Screener pasangan dan kombinasi exchange | Pro, Max |
Parameter dan field ada di bagian dokumentasi Funding rate, Spread funding, dan Analitik funding. Di paket Trial dan Start, endpoint analitik mengembalikan 403 plan_restricted. Untuk gambaran umum API data funding, baca artikel API funding rate. Contoh respons di bawah menampilkan field data dalam bentuk singkat.
Rate dan normalisasi ke 8 jam
/funding/rates mengembalikan, untuk tiap koin, daftar exchange beserta rate saat ini. Filter coin dan exchange (dipisah koma untuk beberapa exchange) bersifat opsional.
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"
}
]
}
| Field | Arti |
|---|---|
funding_pct | Rate per interval settlement, % |
funding_8h_pct | Rate yang dinormalisasi ke 8 jam, % |
interval | Interval settlement, mis. 8h; null — tidak ada data |
next_payout | Waktu payout berikutnya, JJ:MM UTC; null — tidak ada data |
price, trade_url | Harga dan tautan ke terminal trading exchange |
Contoh hipotetis: rate per jam 0,005% sama dengan 0,005 × 8 / 1 = 0,04% per 8 jam, sama seperti MEXC, hanya saja dibayarkan delapan kali dan bisa berubah pada jam berikutnya.
Jika disetahunkan tanpa compounding, rate 8 jam × 3 × 365 menghasilkan APR. Contoh hipotetis: 0,01% setiap 8 jam menghasilkan 0,01 × 3 × 365 = 10,95% per tahun, selama rate bertahan. Apa yang dikatakan rate tentang pasar dibahas di Funding rate sebagai indikator pasar.
Spread funding: pasangan exchange terbaik
/funding/spread mengembalikan, untuk tiap koin, pasangan exchange terbaik berdasarkan spread funding (best) dan exchange lainnya (others). Filter: coin dan min_spread, yaitu spread minimum dalam %.
{
"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 adalah spread pasangan terbaik, %. funding_1_pct dan funding_2_pct adalah rate per interval masing-masing (interval_1, interval_2): untuk membandingkannya secara manual, normalisasi keduanya ke 8 jam. Short dibuka di sisi dengan rate lebih tinggi, long di sisi dengan rate lebih rendah. Hyperliquid muncul sebagai Hyper di respons.
Skrip Python mencetak sepuluh koin dengan spread_pct tertinggi (mulai 0,05%) beserta interval settlement pasangannya. Saat 429 dan 503, skrip menunggu Retry-After detik; dalam loop, ulangi request paling sering sekali per meta.freshness_sec.
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"]}')
Analitik funding yang sudah settle
Empat endpoint /funding/analytics/… mengembalikan riwayat funding yang sudah settle di 13 exchange — data yang sama dengan tab Analitik di Funding Arbitrage. Rate dalam persen per periode settlement, timestamp dalam epoch detik UTC.
| Endpoint | Isi | Bagian penuh | Tanpa coin, maksimal |
|---|---|---|---|
/funding/analytics/summary | Total, rata-rata rate, APR, dan cakupan untuk 7 periode | ~600 KB gzip | sekali per 60 dtk |
/funding/analytics/recent | Semua payout selama 7 hari | ~1 MB gzip | sekali per 60 dtk |
/funding/analytics/daily | Total harian selama 365 hari | hingga ~12 MB gzip | sekali per 300 dtk |
/funding/analytics/top | 50 pasangan teratas dan 50 kombinasi teratas per periode | — | tanpa batas |
Unduhan penuh sebelum jendela berakhir mendapat 429 dengan Retry-After. Aturan ETag dan kompresi dibahas di panduan format respons dan error.
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 meminta respons terkompresi dan mendekompresinya, sedangkan -i mencetak header, termasuk ETag. Kirim request pertama tanpa If-None-Match.
Summary dan array m
Setiap pasangan koin×exchange di summary punya m: kuncinya adalah periode (1d, 3d, 7d, 30d, 90d, 180d, 365d), nilainya 14 angka dalam urutan metric_order. Periode tidak ada di m jika sama sekali tidak ada datanya.
{
"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 | Indeks | Arti |
|---|---|---|
sum | 0 | Akumulasi selama periode, % |
avg8h | 1 | Rate rata-rata dalam satuan 8 jam, % |
apr | 2 | Disetahunkan, % |
n | 3 | Jumlah settlement |
pos, neg, zero | 4–6 | Settlement positif, negatif, dan nol |
min, max | 7–8 | Settlement terkecil dan terbesar, % |
cov | 9 | Cakupan periode dari 0 sampai 1 |
med8h | 10 | Median dalam satuan 8 jam, % |
pos_streak, neg_streak | 11–12 | Jumlah hari berturut-turut positif dan negatif |
flips | 13 | Perubahan tanda |
Indeks 10–13 bernilai null untuk periode 1d dan 3d. Jika cov < 0,9, data hanya mencakup sebagian periode, jadi tandai nilai seperti itu. Pada contoh, BTC di Binance selama 7 hari: 21 settlement, semuanya positif, cov 1,0, dan apr sama dengan avg8h × 3 × 365: 0,006298 × 1095 ≈ 6,896.
Jika avg8h jauh di atas med8h, ada lonjakan yang menggelembungkan rata-rata: median, pos_streak, dan flips menunjukkan stabilitas dengan lebih baik. Field lain dari pasangan itu:
data_since— awal data; jangan menggambar nol sebelum tanggal ini.last8h— rate terbaru dalam satuan 8 jam, untuk perbandingan "sekarang vs normal".interval_h— interval settlement: 8 atau 4 jam di CEX, 1 jam di Hyperliquid dan Lighter.canondanmult— nama yang menggabungkan varian ticker (1000PEPE→PEPE) dan pengali kontrak;multtidak pernah diterapkan ke rate.
Payout 7 hari dan total harian
Di /funding/analytics/recent, setiap exchange punya string s berbentuk ts:rate;ts:rate;… dengan urutan waktu naik dan interval i dalam jam. Di /funding/analytics/daily, string day_ts:sum:pos:neg;… berisi tengah malam UTC, total hari itu, serta jumlah settlement positif dan negatif.
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
Screener kombinasi
/funding/analytics/top adalah screener siap pakai tanpa parameter: untuk tiap periode, 50 pasangan koin×exchange teratas berdasarkan funding akumulasi dan 50 kombinasi short/long teratas. Kaki kombinasi selalu berada di exchange berbeda dengan cakupan minimal 0,9, dan baris dengan net ≤ 0 tidak pernah muncul.
by_net_apr— berdasarkan hasil bersih.by_stable—win_rate≥ 0,7 dan drawdown tidak lebih dari setengah gross.by_live—live_8h> 0 dantrend_1d> 0.by_sum_pos,by_sum_neg— daftar teratas satu exchange berdasarkan funding akumulasi, hanya dengancov≥ 0,5.
| Field kombinasi | Arti |
|---|---|
gross, fees, net | Funding kotor, fee empat transaksi sesuai taker_fees, dan net = gross − fees |
apr_net, apr_capital | Disetahunkan atas notional satu kaki, dan apr_net / 2 atas modal kedua kaki |
win_rate, max_dd | Porsi hari yang menguntungkan (0..1) dan drawdown maksimum hasil kumulatif |
worst_streak, risk_days | Rentetan hari rugi terpanjang dan jumlah hari pengukuran risiko, maks 90 |
live_8h, trend_1d, trend_7d | Selisih rate saat ini per 8 jam serta spread gross selama sehari dan seminggu terakhir |
price_div | Selisih harga saat ini antar kaki; null jika harga tidak tersedia |
short_sym, long_sym | Ticker kaki sebenarnya di exchange, yang bisa berbeda: PEPE dan 1000PEPE |
Pada contoh di dokumentasi, kombinasi PEPE — short di HTX, long di Hyperliquid — memperoleh gross 1,51504% selama 7 hari. Fee-nya 0,05% untuk buka dan 0,05% untuk tutup di HTX, serta masing-masing 0,045% di Hyperliquid: 0,05 × 2 + 0,045 × 2 = 0,19.
Jadi net = 1,51504 − 0,19 = 1,32504%, apr_net = 1,32504 × 365 / 7 ≈ 69,09%, apr_capital = 69,09 / 2 ≈ 34,55%. Selisih harga antar kaki, slippage, dan margin tidak termasuk.
Cara membangun monitor funding
Cari kandidat
Panggil
/funding/spreaddenganmin_spread(paket API apa pun) dan urutkan berdasarkanspread_pct.Periksa rate dan payout
Panggil
/funding/ratesdengancoin:interval,next_payout, danfunding_8h_pctdi kedua exchange. Posisi harus sudah terbuka pada waktu settlement.Lihat riwayatnya
Di Pro dan Max, panggil
/funding/analytics/summarydengancoin:sum,apr,cov, danflipsuntuk 7d dan 30d menunjukkan apakah selisih rate bertahan.Nilai kombinasi secara keseluruhan
Di
/funding/analytics/top, bandingkannet,apr_capital,win_rate,max_dd, danprice_divsaat ini.Buka posisi sendiri
Tautan
trade_urlmengarah ke terminal exchange; hitung kombinasi beserta fee di kalkulator spread.
Tanya jawab
Bagaimana cara menormalisasi funding rate ke 8 jam?
Kalikan rate per interval dengan 8 lalu bagi dengan panjang interval dalam jam. /funding/rates melakukannya untuk Anda di field funding_8h_pct.
Di mana saya mendapat riwayat funding rate?
/funding/analytics/recent berisi semua payout selama 7 hari, /funding/analytics/daily total harian selama setahun, dan /funding/analytics/summary total per periode. Ketiganya ada di paket API Pro dan Max.
Mengapa bagian analitik penuh mengembalikan 429?
Unduhan penuh tanpa coin dibatasi: summary dan recent sekali per 60 detik, daily sekali per 300 detik per key. Irisan koin dan respons 304 untuk If-None-Match tidak dibatasi.