Genesis Arbitrage

Genesis Arbitrage · · 12 menit baca

Data API untuk arbitrase kripto: spread, order book, funding

Ringkasan

  • Setiap pertanyaan trader punya endpoint sendiri: selisih harga adalah spread_pct di /arbitrage/*, transfer koin adalah flag deposit dan penarikan plus network dan contract, eksekusi untuk ukuran Anda ada di /orderbooks/*, dan skenario funding ada di /funding/*.
  • Spread baris dihitung dari transaksi terakhir. Pada contoh ilustrasi, 1,5% untuk $2.500 menyusut menjadi 0,72% setelah order book ditelusuri, dan menjadi sekitar 0,52%, kira-kira $13, setelah dua fee taker 0,1%.
  • Setiap respons membawa waktunya sendiri: meta.updated_at adalah saat snapshot dibuat, meta.freshness_sec adalah langkah pembaruan paket Anda, sedangkan age_sec dan stale menunjukkan usia order book.
  • Satu pair diperiksa di empat titik: selisih harga, transfer, order book, dan kesegaran. Jika salah satu gagal, entry dibatalkan.
  • Arbitrase CEX, funding, dan open interest tersedia di setiap paket Genesis API, bagian on-chain mulai dari Start, sedangkan order book dan data DEX hadir bersama Pro dan Max.

Data arbitrase kripto menjawab lima pertanyaan: apakah ada selisih harga, apakah koin bisa dipindahkan, apakah order book cukup dalam untuk ukuran Anda, apakah funding membayar, dan apa yang dilakukan pemain besar. Di Genesis API setiap pertanyaan punya endpoint sendiri dan beberapa field respons. Request pertama dan amplop success, data, meta dibahas di pelajaran 2; pelajaran ini membahas field mana yang dibaca dan dalam urutan apa.

Pertanyaan trader → endpoint → field

PertanyaanEndpointField
Apakah ada selisih harga/arbitrage/*spread_pct, price_buy, price_sell
Apakah koin bisa dipindahkanbaris /arbitrage/spot-spot yang samawithdraw_enabled_buy, deposit_enabled_sell, network, contract
Apakah book cukup dalam/orderbooks/*order_delta.spread_pct, order_delta.status
Apakah funding membayar/funding/*spread_pct, interval_1, interval_2, next_payout_1
Apa yang dilakukan pemain besar/onchain/*, /market/open-interestdirection, total_usd, oi_change_1h

Tanda bintang menandai grup: /arbitrage/* berisi tujuh endpoint, dari Spot – Spot hingga saham, sedangkan /orderbooks/* dan /funding/* masing-masing berisi enam. Bagian-bagian di bawah mengikuti urutan pemeriksaan sebuah pair.

Apakah ada selisih harga: spread_pct

Satu baris dari dokumentasi Spot — Spot: FUEL, beli di ByBit di 0,0007029, jual di Gate di 0,0007037, spread_pct 0,11. Pengecekan: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11%. Spread baris dihitung dari price_buy dan price_sell, yaitu harga transaksi terakhir; di situs ini adalah kolom Harga.

Pada dataset DEX – Spot dan DEX – Futures tandanya penting: plus berarti token lebih murah di DEX, minus berarti lebih mahal. Parameter dan field ketujuh dataset ada di panduan endpoint arbitrase.

spread_pct hanya menjawab pertanyaan pertama: tidak ada fee, transfer, maupun order book di dalamnya.

Apakah koin bisa dipindahkan: deposit, penarikan, jaringan, dan kontrak

Pair spot lintas exchange membutuhkan transfer: Anda membeli koin di satu exchange, menariknya, lalu mendepositkannya di exchange lain. Karena itu baris memiliki dua flag yang perlu dibaca: withdraw_enabled_buy, yaitu apakah penarikan dibuka di exchange beli, dan deposit_enabled_sell, yaitu apakah deposit dibuka di exchange jual. Request tidak punya parameter untuk keduanya, jadi kode Anda yang memfilter baris.

network dan contract menunjukkan apakah itu token yang sama. Koin yang berbeda bisa diperdagangkan dengan satu ticker di exchange yang berbeda, jadi bandingkan alamat kontrak dengan halaman penarikan dan deposit di kedua exchange. Kontrak sebuah koin per jaringan, beserta exchange yang memakai masing-masing, didapat dari /coins/search di paket mana pun (Coin Search).

Pada dataset DEX, flag-nya milik sisi CEX: deposit_enabled dan withdraw_enabled. Di Cross-chain token berpindah lewat bridge antara jaringan buy.chain dan sell.chain, jadi tidak ada flag exchange.

Apakah order book cukup dalam: spread baris vs spread setelah eksekusi

Market order menelusuri order book: beli mengambil ask ke atas mulai dari yang terbaik, jual mengambil bid ke bawah. Makin besar ukurannya, makin buruk harga rata-ratanya dan makin sedikit sisa spread baris. Δ order book, yaitu /orderbooks/spreads/{dataset} di paket Pro dan Max, mengembalikan sisa untuk ukuran Anda (dokumentasi).

Contoh ilustrasi: koin LMN, beli di OKX di 0,4000, jual di Bitget di 0,4060. Spread baris: (0,4060 − 0,4000) / 0,4000 × 100 = 1,5%. Request /orderbooks/spreads/spot-spot dengan coin=LMN pada nilai volume yang berbeda:

UkuranBeli → jualΔ order bookDalam dolar
00,4002 → 0,40581,3993%—
$5000,4004 → 0,40551,2737%$6,37
$2.5000,4012 → 0,40410,7228%$18,07
$10.000—exhausted—

volume=0 memakai ask terbaik OKX dan bid terbaik Bitget: order terbaik berada lebih buruk daripada transaksi terakhir, sehingga 0,1 poin persentase hilang bahkan pada ukuran terkecil. Pada $2.500 harga beli rata-rata adalah 0,4012 dan harga jual rata-rata 0,4041: (0,4041 − 0,4012) / 0,4012 × 100 ≈ 0,7228%. Pada $10.000 bid di Bitget habis dan order_delta.status bernilai exhausted.

Setiap exchange memungut fee taker; contoh ini mengasumsikan 0,1% (maker dan taker). Pada $2.500 Anda menyisakan 0,7228 − 2 × 0,1 = 0,5228%, atau 2.500 × 0,5228 / 100 ≈ $13,07. Fee penarikan tidak ada di respons: lihat di halaman penarikan exchange dan kurangkan secara terpisah.

Di paket Trial dan Start endpoint order book mengembalikan 403 plan_restricted, jadi book diperiksa di terminal exchange. Harga eksekusi dan slippage dijelaskan di API order book kripto, dan keenam endpoint ada di panduan endpoint order book.

Apakah funding membayar: spread, interval, dan pembayaran

Arbitrase funding berarti short di tempat funding rate lebih tinggi dan long di tempat lebih rendah: pergerakan harga nyaris tidak mengubah hasil, sementara selisih rate terakumulasi. Kandidat datang dari /funding/spread di paket mana pun: pasangan exchange terbaik ada di best beserta spread_pct-nya (Funding spread).

Spread pair tidak menunjukkan kapan dan seberapa sering pembayaran terjadi. interval_1 dan interval_2 adalah interval funding kedua exchange, sedangkan next_payout_1 dan next_payout_2 adalah waktu pembayaran berikutnya dalam UTC: hanya posisi yang terbuka saat settlement yang menerima funding. Rate dengan interval berbeda dibandingkan setelah dinormalkan ke 8 jam, yaitu field funding_8h_pct di /funding/rates.

Contoh ilustrasi: spread 0,03% per 8 jam, dengan posisi $5.000 di setiap sisi. Satu settlement menghasilkan 5.000 × 0,03 / 100 = $1,5. Empat transaksi, membuka dan menutup kedua sisi, berbiaya 4 × 5.000 × 0,1 / 100 = $20 pada fee taker 0,1%. Fee impas setelah 20 / 1,5 ≈ 13,3 settlement: itu 14 settlement delapan jam, hampir lima hari, jika rate bertahan.

Riwayat menunjukkan apakah selisih itu bertahan: di Pro dan Max, /funding/analytics/summary dengan coin mengembalikan, untuk setiap exchange, sum (funding terakumulasi), cov (cakupan), dan flips (perubahan tanda) untuk setiap periode. Rinciannya ada di API funding rate dan panduan endpoint funding.

Apa yang dilakukan pemain besar: on-chain dan open interest

Data on-chain dan open interest menjelaskan mengapa sebuah pair bisa tertutup sebelum Anda mengeksekusinya. Koin yang mengalir ke exchange jual berarti penjual yang tiba sebelum transfer Anda. Open interest yang naik berarti posisi berleverage baru, dan pergerakan tajam melawan mereka memicu likuidasi.

Yang terlihatRequestFieldPaket
Aliran koin ke dan dari exchange/onchain/coin-trafficdirection, target, total_usdStart, Pro, Max
Unlock token/onchain/unlocksunlock_value_usd, hours_leftStart, Pro, Max
Open interest per exchange/market/open-interestoi_usd, oi_change_1h, price_change_1hSemua

Contoh respons di dokumentasi Genesis Onchain menampilkan 18 transfer LAB ke Gate senilai $573.796,98 dalam 5,69 jam, dengan direction bernilai deposit. Jika saat itu ada pair yang menjual LAB di Gate, aliran seperti itu adalah alasan untuk memperkecil ukuran atau melewati entry. Selengkapnya di API data on-chain dan API open interest.

Kesegaran data dan timestamp

Setiap respons membawa waktunya: meta.updated_at adalah waktu unix saat snapshot dibuat, dan meta.freshness_sec adalah langkah pembaruan paket Anda: 60 detik di Trial, 30 di Start, 10 di Pro, dan 5 di Max. Usia snapshot adalah waktu sekarang dikurangi updated_at (kesegaran data).

Contoh ilustrasi: paket Trial, respons tiba pada 1783802455 dan updated_at adalah 1783802410. Usia snapshot 1783802455 − 1783802410 = 45 detik: pair-nya dihitung dari harga yang hampir semenit lalu, dan sebagian mungkin sudah hilang di exchange.

Order book punya jam sendiri: di /orderbooks/book dan /orderbooks/coin/{coin} setiap book memiliki book_ts, age_sec (usianya dalam detik), dan stale: true bila lebih tua dari 30 detik. Book tertinggal 5–20 detik dari exchange, jadi periksa usia kedua sisi: selisih harga antara book yang segar dan yang lama bisa jadi selisih waktu.

Mengapa satu field tidak cukup: pemeriksaan empat titik

Setiap field menutup satu pertanyaan, dan Anda baru boleh masuk setelah semuanya tertutup. Spread 3% dengan penarikan tertutup membuat koin tersangkut di exchange beli. Dengan exhausted ukuran Anda tidak akan terisi. Dengan snapshot berusia 50 detik, pair mungkin sudah hilang.

TitikFieldPair gagal jika
1. Selisih hargaspread_pctspread dikurangi dua fee di bawah ambang
2. Transferwithdraw_enabled_buy, deposit_enabled_sell, contractpenarikan atau deposit tertutup, atau kontrak tidak cocok
3. Order bookorder_delta.status, order_delta.spread_pctstatus bukan ok atau sisanya di bawah ambang
4. Kesegaranmeta.updated_at, age_sec, stalesnapshot atau sebuah book lebih tua dari ambang

Fungsi ini menerima satu baris data dari /arbitrage/spot-spot, objek order_delta untuk pasangan exchange yang sama (None di Trial dan Start), dan meta dari respons. Ambangnya hanya ilustrasi: sesuaikan dengan fee dan paket Anda.

import time

FEE = 0.1      # asumsi fee taker per sisi, %
MIN_NET = 0.3  # minimal 0,3% tersisa setelah fee
MAX_AGE = 60   # snapshot paling lama 60 detik


def check(row, od, meta):
    """Titik yang gagal untuk sebuah pair Spot – Spot."""
    fails = []
    if row["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("1: spread tidak menutup fee")
    if not row["withdraw_enabled_buy"]:
        fails.append("2: penarikan tertutup di exchange beli")
    if not row["deposit_enabled_sell"]:
        fails.append("2: deposit tertutup di exchange jual")
    if od is None:
        fails.append("3: book tidak diperiksa (Trial atau Start)")
    elif od["status"] != "ok":
        fails.append("3: book — " + od["status"])
    elif od["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("3: sisa terlalu kecil setelah book")
    if time.time() - meta["updated_at"] > MAX_AGE:
        fails.append("4: snapshot lebih tua dari MAX_AGE detik")
    return fails

Daftar kosong berarti pair lolos keempat titik. Pair LMN pada $2.500 lolos: 1,5 − 0,2 = 1,3% pada baris, 0,7228 − 0,2 = 0,5228% setelah book, dan snapshot berusia 45 detik. Pada $10.000 fungsi mengembalikan "3: book — exhausted". Kode tidak bisa memverifikasi kontrak: Anda memeriksa alamatnya di halaman penarikan dan deposit exchange, dan usia book kedua sisi didapat dari /orderbooks/book.

Pemeriksaan yang sama pada tabel situs, tanpa kode, ada di pelajaran Spread, kedalaman, volume — membaca tabel, dan polling API dalam loop ada di pelajaran 4.

Data apa untuk paket apa

PaketKesegaranData arbitrase
Trial, $20 per bulan60 dtkSpot – Spot, Spot – Futures, Futures – Futures, funding rate dan spread, open interest, Fair – Last, pump, pencarian koin
Start, $5030 dtkSemua di Trial plus saham, bagian on-chain /onchain/{section}, arbitrase prediksi dalam mode exact dan dutch
Pro, $10010 dtkSemua endpoint: order book dan Δ order book, DEX – Spot, DEX – Futures, Cross-chain, analitik funding
Max, $2005 dtkEndpoint yang sama dengan Pro, dengan 15 request per detik

Endpoint di luar paket Anda mengembalikan 403 plan_restricted, dan respons itu tidak memakai kuota. Kuota panggilan dan batas request per detik ada di halaman harga Genesis API.

Praktik

  1. Ambil satu pair

    Di dokumentasi Spot — Spot, buka formulir Coba sekarang, tempel key Anda, dan pilih baris dengan spread 1% atau lebih.

  2. Jalankan titik 1 dan 2

    Kurangi spread_pct dengan dua fee 0,1% yang diasumsikan, lalu periksa withdraw_enabled_buy dan deposit_enabled_sell. Bandingkan contract dengan respons /coins/search untuk koin ini.

  3. Jalankan titik 3

    Di Pro atau Max, kirim request /orderbooks/spreads/spot-spot dengan koin ini dan volume=1000, lalu cari baris dengan pasangan exchange yang sama. Di Trial dan Start, buka order book di terminal exchange.

  4. Jalankan titik 4

    Kurangi waktu unix sekarang dengan meta.updated_at: date +%s mencetaknya di terminal.

  5. Tulis kesimpulannya

    Titik mana yang pertama kali menolak pair ini, dan berapa sisa spread pada $1.000.

Tanya jawab

Data apa yang dibutuhkan untuk arbitrase kripto?

Harga koin di berbagai exchange dan spread di antaranya, status deposit dan penarikan beserta jaringan dan kontrak, order book untuk menghitung eksekusi pada ukuran Anda, dan waktu snapshot. Arbitrase funding menambahkan rate, interval, dan waktu pembayaran. Di Genesis API itu adalah /arbitrage/*, /orderbooks/*, dan /funding/*.

Bisakah membuka transaksi lewat Genesis API?

Tidak. Genesis API hanya membaca data dan tidak menempatkan order: Anda membuka transaksi sendiri di exchange.