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, danspread_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:
- API exchange: akses data dan akun satu exchange. Exchange menyediakan harga, order book, dan trade secara publik, sedangkan saldo, order, dan riwayat trade memerlukan key dan request bertanda tangan. Binance menjabarkannya sebagai tipe keamanan:
NONEuntuk data pasar terbuka,TRADEuntuk menempatkan dan membatalkan order,USER_DATAuntuk detail akun (dokumentasi Binance). - API data pasar: banyak exchange dan jaringan dalam satu format. API ini menyajikan hal yang butuh penggabungan beberapa exchange: spread antar exchange, funding rate yang dinormalisasi ke satu periode, open interest per exchange. Genesis API termasuk jenis ini, dan hanya membaca data.
- API on-chain: data blockchain seperti transaksi, transfer token, dan saldo alamat. Label seperti "exchange", "tim proyek", atau "whale" berasal dari layanan analitik yang dibangun di atas data jaringan.
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.
| Tugas | Yang dilakukan program | Data Genesis API |
|---|---|---|
| Pemantauan spread | Pasangan di atas ambang batas dengan deposit dan penarikan terbuka | /arbitrage/spot-spot, /arbitrage/spot-futures |
| Funding | Membandingkan rate antar exchange yang dinormalisasi ke 8 jam | /funding/rates, /funding/spread |
| Open interest | Menangkap perubahan OI yang tajam dalam 5 menit hingga 1 jam | /market/open-interest |
| Alert | Mengirim pesan ke Telegram saat kondisi terpenuhi | Endpoint data apa pun |
| Log | Menyimpan setiap pasangan yang ditemukan beserta timestamp | Respons dan meta.updated_at |
| Dashboard | Menampilkan kolom dan ambang batas Anda di halaman sendiri | Request dari server Anda |
| Riset historis | Mencari 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
| Tugas | Lebih cocok | Alasan |
|---|---|---|
| Menjelajahi pasangan dan grafik | Situs Genesis Arbitrage | Tabel dan filter, tanpa kode |
| Sinyal tanpa pemrograman | Telegram Alert di situs | Ambang batas diatur di antarmuka |
| Aturan sendiri di 20+ exchange | Genesis API | Spread sudah dihitung, satu format |
| Order, saldo, penarikan | API exchange | Hanya exchange yang menerima order |
| Setiap trade secara real time | WebSocket exchange | Genesis API menyajikan snapshot tiap 60–5 dtk |
| Candle historis | API exchange | Genesis API tidak punya candle |
| Riwayat funding di 13 exchange | Genesis API, Pro dan Max | Jumlah 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
- API key Genesis API: pilih paket di halaman harga dan ambil key lewat tombol "Dapatkan key" di profil Anda; langkah-langkahnya ada di panduan memulai Genesis API. Simpan key di variabel lingkungan
GENESIS_API_KEYdan jangan pernah menaruhnya di URL request. - curl untuk request pertama dari terminal.
- Python 3.10+ dan library
requests(pip install requests) untuk skrip di pelajaran 2 dan 4. - Dokumentasi Genesis API: setiap endpoint memiliki parameter, field, contoh curl, dan formulir "Coba sekarang" yang mengirim request langsung dari halaman.
Pelajaran-pelajarannya saling membangun:
- pelajaran 2: request pertama, dengan alamat, header, status code, dan JSON;
- pelajaran 3: data mana yang melayani keputusan mana, dari spread dan order book hingga funding dan aliran on-chain;
- pelajaran 4: monitor spread dan funding dengan Python;
- pelajaran 5: risiko otomatisasi, termasuk data usang, error, key, dan agen AI.
Coba sendiri
Kirim request tanpa key
Jalankan
curl "https://api.genesisarbitrage.com/health"di terminal. Respons{"ok":true}berarti request sampai dan server menjawab dalam JSON.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.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.
Temukan endpoint untuk satu tugas
Untuk tugas Genesis API, temukan endpoint-nya di dokumentasi dan catat parameter yang Anda perlukan, seperti
coindanmin_spread. Request itu akan Anda kirim di pelajaran 2.