Genesis Arbitrage

Genesis Arbitrage · · 11 menit baca

Endpoint funding Genesis API: rate, spread, dan analitik riwayat funding

Ringkasan

  • /funding/rates dan /funding/spread tersedia 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 coin atau ulangi request dengan If-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

EndpointMengembalikanPaket API
/funding/ratesRate semua exchange untuk tiap koinTrial, Start, Pro, Max
/funding/spreadPasangan exchange terbaik berdasarkan spread dan exchange lainnyaTrial, Start, Pro, Max
/funding/analytics/summaryRingkasan untuk periode 1 hari hingga satu tahunPro, Max
/funding/analytics/recentSemua payout selama 7 hariPro, Max
/funding/analytics/dailyTotal harian selama 365 hariPro, Max
/funding/analytics/topScreener pasangan dan kombinasi exchangePro, 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"
    }
  ]
}
FieldArti
funding_pctRate per interval settlement, %
funding_8h_pctRate yang dinormalisasi ke 8 jam, %
intervalInterval settlement, mis. 8h; null — tidak ada data
next_payoutWaktu payout berikutnya, JJ:MM UTC; null — tidak ada data
price, trade_urlHarga 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.

EndpointIsiBagian penuhTanpa coin, maksimal
/funding/analytics/summaryTotal, rata-rata rate, APR, dan cakupan untuk 7 periode~600 KB gzipsekali per 60 dtk
/funding/analytics/recentSemua payout selama 7 hari~1 MB gzipsekali per 60 dtk
/funding/analytics/dailyTotal harian selama 365 harihingga ~12 MB gzipsekali per 300 dtk
/funding/analytics/top50 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]
          }
        }
      }
    }
  }
}
MetrikIndeksArti
sum0Akumulasi selama periode, %
avg8h1Rate rata-rata dalam satuan 8 jam, %
apr2Disetahunkan, %
n3Jumlah settlement
pos, neg, zero4–6Settlement positif, negatif, dan nol
min, max7–8Settlement terkecil dan terbesar, %
cov9Cakupan periode dari 0 sampai 1
med8h10Median dalam satuan 8 jam, %
pos_streak, neg_streak11–12Jumlah hari berturut-turut positif dan negatif
flips13Perubahan 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:

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.

Field kombinasiArti
gross, fees, netFunding kotor, fee empat transaksi sesuai taker_fees, dan net = gross − fees
apr_net, apr_capitalDisetahunkan atas notional satu kaki, dan apr_net / 2 atas modal kedua kaki
win_rate, max_ddPorsi hari yang menguntungkan (0..1) dan drawdown maksimum hasil kumulatif
worst_streak, risk_daysRentetan hari rugi terpanjang dan jumlah hari pengukuran risiko, maks 90
live_8h, trend_1d, trend_7dSelisih rate saat ini per 8 jam serta spread gross selama sehari dan seminggu terakhir
price_divSelisih harga saat ini antar kaki; null jika harga tidak tersedia
short_sym, long_symTicker 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

  1. Cari kandidat

    Panggil /funding/spread dengan min_spread (paket API apa pun) dan urutkan berdasarkan spread_pct.

  2. Periksa rate dan payout

    Panggil /funding/rates dengan coin: interval, next_payout, dan funding_8h_pct di kedua exchange. Posisi harus sudah terbuka pada waktu settlement.

  3. Lihat riwayatnya

    Di Pro dan Max, panggil /funding/analytics/summary dengan coin: sum, apr, cov, dan flips untuk 7d dan 30d menunjukkan apakah selisih rate bertahan.

  4. Nilai kombinasi secara keseluruhan

    Di /funding/analytics/top, bandingkan net, apr_capital, win_rate, max_dd, dan price_div saat ini.

  5. Buka posisi sendiri

    Tautan trade_url mengarah 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.