Genesis Arbitrage

Genesis Arbitrage · · 9 menit baca

Apa itu API kripto dan apa yang bisa diotomatisasi

Ringkasan

  • API kripto adalah antarmuka pemrograman yang dipakai program Anda untuk meminta data pasar dan menerima respons JSON: spread yang sama dengan di tabel situs, dikirim sebagai field exchange_buy, exchange_sell, dan spread_pct.
  • API exchange mencakup data dan akun satu exchange, API data pasar menggabungkan banyak exchange dalam satu format, dan API on-chain membaca blockchain. Genesis API adalah API data pasar yang hanya bisa dibaca (read-only).
  • Dengan API, trader mengotomatisasi pemantauan spread, funding, dan open interest, alert, log sinyal, dashboard, serta riset data historis.
  • Tanpa pengalaman, lakukan eksekusi trade dan penarikan secara manual: snapshot data tertinggal dari exchange, dan bug di kode Anda terulang di setiap siklus.

API kripto adalah antarmuka pemrograman yang dipakai kode Anda untuk meminta data pasar kripto dan menerima jawaban yang bisa langsung diolah: harga, spread antar exchange, funding rate, open interest. Manusia membaca angka-angka ini di tabel; program menerimanya sebagai field JSON dan bisa langsung membandingkannya dengan ambang batas, mencatatnya ke log, atau mengirim alert. Definisi umumnya ada di entri glosarium API.

Request dan respons

Bekerja dengan API berarti bertukar dua pesan: program Anda mengirim request ke sebuah alamat, lalu server mengirim respons. Contoh terpendek adalah pengecekan status Genesis API, yang tidak butuh key:

curl "https://api.genesisarbitrage.com/health"
{"ok":true}

curl adalah program command-line untuk request HTTP; curl --version menunjukkan apakah curl sudah terpasang. Request data membutuhkan API key, yaitu string yang dipakai server untuk mengenali akun dan paket Anda. Contoh ilustrasi: pasangan Spot – Spot untuk koin FUEL, dengan key diambil dari variabel lingkungan GENESIS_API_KEY:

URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
  "success": true,
  "data": [
    {
      "coin": "FUEL",
      "exchange_buy": "ByBit",
      "exchange_sell": "Gate",
      "price_buy": 0.0007029,
      "price_sell": 0.0007037,
      "spread_pct": 0.11,
      "withdraw_enabled_buy": true,
      "deposit_enabled_sell": true,
      …
    }
  ],
  "meta": {
    "count": 1,
    "updated_at": 1794675861,
    "freshness_sec": 60,
    "plan": "trial"
  }
}

Respons berisi satu pasangan: beli FUEL di ByBit seharga 0,0007029 dan jual di Gate seharga 0,0007037. Spread sudah dihitung di spread_pct: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11%. Flag withdraw_enabled_buy dan deposit_enabled_sell menunjukkan bahwa penarikan dari ByBit dan deposit ke Gate sedang terbuka, sedangkan meta.updated_at menunjukkan kapan snapshot dibuat. Tabel Spot – Spot menampilkan angka yang sama, dan setiap field dijelaskan di bagian Spot — Spot pada dokumentasi.

Alamat request tersusun dari base URL, path endpoint, dan parameter, sementara key dikirim terpisah lewat header X-API-Key. Pelajaran 2 membahas tiap bagian request satu per satu, mencakup status code dan cara membaca JSON, serta menunjukkan cara mengatur variabel key.

Pertukaran semacam ini, yaitu request yang dijawab dengan respons berisi snapshot data, disebut REST API. Data baru didapat dengan mengirim request lagi: Genesis API memperbarui outputnya setiap meta.freshness_sec detik, dari 60 di Trial hingga 5 di Max. Exchange juga menawarkan kanal kedua, WebSocket: koneksi tetap terbuka dan server mengirim trade serta perubahan order book begitu terjadi, seperti pada stream Binance. Genesis API tidak memiliki WebSocket.

Jenis-jenis API kripto

API kripto berbeda dalam hal asal datanya dan apa yang bisa Anda lakukan lewat API tersebut:

Perbandingan enam jenis API, REST versus WebSocket, dan checklist sembilan poin untuk memilih ada di ulasan jenis API kripto dan cara memilihnya.

Yang bisa diotomatisasi trader

Otomatisasi apa yang Anda ulangi dengan aturan tetap: membuka tabel, membandingkan angka dengan ambang batas, mencatat hasilnya. Program melakukannya sesuai jadwal dan tidak melewatkan jam malam.

TugasYang dilakukan programData Genesis API
Pemantauan spreadPasangan di atas ambang batas dengan deposit dan penarikan terbuka/arbitrage/spot-spot, /arbitrage/spot-futures
FundingMembandingkan rate antar exchange yang dinormalisasi ke 8 jam/funding/rates, /funding/spread
Open interestMenangkap perubahan OI yang tajam dalam 5 menit hingga 1 jam/market/open-interest
AlertMengirim pesan ke Telegram saat kondisi terpenuhiEndpoint data apa pun
LogMenyimpan setiap pasangan yang ditemukan beserta timestampRespons dan meta.updated_at
DashboardMenampilkan kolom dan ambang batas Anda di halaman sendiriRequest dari server Anda
Riset historisMencari pola pada data masa lalu/funding/analytics/daily (Pro, Max)

Alert adalah proyek pertama yang umum: program memanggil endpoint paling sering sesuai meta.freshness_sec dan mengirim pesan saat spread atau rate melewati ambang batas Anda. Tanpa kode, sinyal serupa tersedia lewat Telegram Alert Genesis Arbitrage di situs pada paket Pro.

Log menguji sebuah ide sebelum ada uang yang dipertaruhkan. Contoh ilustrasi: bot mencatat pasangan dengan spread 1% atau lebih setiap 30 detik, yaitu 86.400 / 30 = 2.880 snapshot per hari. Snapshot itu menunjukkan berapa pasangan yang bertahan lebih dari semenit dan berapa yang sudah hilang pada polling berikutnya.

Untuk data historis, Genesis API menyediakan analitik funding, yaitu jumlah funding harian yang sudah settle hingga setahun di 13 exchange, dan riwayat slippage order book; keduanya ada di paket Pro dan Max. Genesis API tidak memiliki candle historis: candle disediakan API exchange, di Binance lewat GET /api/v3/klines dengan hingga 1.000 candle per request (dokumentasi Binance). Riwayat spread antar exchange dibangun sendiri oleh program Anda dari snapshot di lognya.

Yang jangan diotomatisasi tanpa pengalaman

Dua operasi mahal bila salah: eksekusi trade dan penarikan.

Eksekusi trade

Bot yang menempatkan order lewat API trading exchange membuat kesalahan sesering ia berjalan: bug pada kondisi entry dengan polling tiap 10 detik menghasilkan 3.600 / 10 = 360 order per jam. Datanya juga tertinggal: snapshot Genesis API diperbarui setiap 60 hingga 5 detik tergantung paket, order book tertinggal 5–20 detik dari exchange, dan spread bisa menutup dalam waktu itu. Genesis API tidak menempatkan order: API ini menemukan pasangan, dan Anda membuka trade di exchange sendiri.

Penarikan

Key exchange dengan izin penarikan memungkinkan siapa pun yang memegangnya memindahkan dana keluar dari akun, sehingga kebocoran key semacam itu bisa menguras seluruh saldo. Bot yang hanya membaca data atau melakukan trading tidak memerlukan izin ini. Di Binance, API key baru bahkan tidak bisa trading secara default: izin trading diaktifkan terpisah.

Situs, API exchange, atau Genesis API

TugasLebih cocokAlasan
Menjelajahi pasangan dan grafikSitus Genesis ArbitrageTabel dan filter, tanpa kode
Sinyal tanpa pemrogramanTelegram Alert di situsAmbang batas diatur di antarmuka
Aturan sendiri di 20+ exchangeGenesis APISpread sudah dihitung, satu format
Order, saldo, penarikanAPI exchangeHanya exchange yang menerima order
Setiap trade secara real timeWebSocket exchangeGenesis API menyajikan snapshot tiap 60–5 dtk
Candle historisAPI exchangeGenesis API tidak punya candle
Riwayat funding di 13 exchangeGenesis API, Pro dan MaxJumlah harian hingga setahun, satu format

Susunan praktis untuk memulai: Genesis API menemukan pasangan, bot Anda mengirim alert, dan Anda memeriksa order book di exchange lalu membuka trade sendiri. Paket Genesis API berkisar dari Trial seharga $20 per bulan (500K panggilan, kesegaran 60 dtk) hingga Max seharga $200 (10M panggilan, 5 dtk), dan tidak ada paket gratis. Bandingkan di halaman harga Genesis API.

Yang Anda perlukan untuk sisa kursus

Pelajaran-pelajarannya saling membangun:

Coba sendiri

  1. Kirim request tanpa key

    Jalankan curl "https://api.genesisarbitrage.com/health" di terminal. Respons {"ok":true} berarti request sampai dan server menjawab dalam JSON.

  2. Cocokkan tabel dengan field

    Buka tabel Spot – Spot dan bagian dokumentasi Spot — Spot. Temukan field untuk exchange, harga, spread, dan status transfer: exchange_buy, price_sell, spread_pct, withdraw_enabled_buy.

  3. Daftar tugas rutin Anda

    Ambil tiga hal yang Anda lakukan setiap hari dan tandai masing-masing memakai tabel di atas: situs, Genesis API, atau API exchange.

  4. Temukan endpoint untuk satu tugas

    Untuk tugas Genesis API, temukan endpoint-nya di dokumentasi dan catat parameter yang Anda perlukan, seperti coin dan min_spread. Request itu akan Anda kirim di pelajaran 2.