API
API (application programming interface) adalah seperangkat aturan yang dipakai satu program untuk meminta data atau tindakan dari program lain: URL mana yang dipanggil, apa yang dikirim, dan dalam format apa respons datang. Trader membutuhkan API ketika harga, order book, dan funding rate harus dibaca oleh program: bot, spreadsheet, atau dasbor.
Contoh request
Contoh hipotetis: sebuah program meminta profil koin IRYS dari Genesis API lewat endpoint Coin Search, lihat endpoint. Request-nya adalah HTTP GET, dengan key di header:
curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
-H "X-API-Key: $GENESIS_API_KEY"
Respons datang dalam bentuk JSON, beberapa field dihilangkan:
{
"coin": "IRYS",
"contracts": [
{
"address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
"network": "BNB Smart Chain(BEP20)",
"exchanges": ["MEXC", "Ourbit"]
}
],
"exchanges": {
"MEXC": {
"spot_price": 0.01329,
"futures_price": 0.0133,
"deposit": true,
"withdraw": true
}
}
}
Manusia harus menyusun ini dari halaman exchange dan block explorer; program mendapatkannya dalam satu respons dan langsung bisa menghitung bahwa futures MEXC diperdagangkan di atas spot sebesar (0,0133 − 0,01329) / 0,01329 × 100 ≈ 0,075%.
API exchange publik dan privat
API exchange punya dua bagian. Bagian publik menyajikan data pasar (harga, order book, transaksi) tanpa key. Bagian privat bekerja dengan akun Anda (saldo, order, riwayat transaksi) dan memerlukan API key plus tanda tangan request. Di Binance, endpoint publik memiliki tipe keamanan NONE; semua yang lain memerlukan key dan parameter signature.
Data tiba lewat dua cara. REST API menjawab setiap request secara terpisah: begitulah Anda mendapat snapshot data dengan filter yang diperlukan. WebSocket menjaga koneksi tetap terbuka dan server mengirim pembaruan sendiri: begitulah Binance menyalurkan transaksi dan perubahan order book secara real time.
API data: banyak platform dalam satu respons
API exchange hanya mengenal platformnya sendiri. Untuk membandingkan harga satu koin di 20 exchange, program membutuhkan 20 koneksi, dan setiap exchange punya format respons serta limit sendiri. API data menggabungkan platform-platform itu terlebih dahulu.
| Jenis API | Yang dikembalikan | Akses |
|---|---|---|
| API exchange publik | Harga, order book, dan transaksi satu exchange | Tanpa key |
| API exchange privat | Saldo, order, penarikan | Key dan tanda tangan |
| Genesis API | Spread, order book, funding, DEX, on-chain, pasar prediksi | Key, hanya baca |
Satu request ke endpoint /arbitrage/spot-spot Genesis API mengembalikan spread terhitung antar pasar spot di 20+ exchange CEX, lengkap dengan flag deposit dan penarikan. Setiap request adalah HTTP GET, setiap respons adalah JSON, dan parameter serta field tiap endpoint ada di dokumentasi.
Lihat juga: API kripto: jenis dan cara memilih, mulai cepat di dokumentasi, rate limit, pelajaran: apa itu API kripto.
Tanya jawab
Apakah saya butuh SDK untuk bekerja dengan API?
Jika API berbicara HTTP, klien HTTP apa pun cukup. Untuk Genesis API, curl, requests di Python, atau fetch bawaan JavaScript sudah memadai.
Bisakah saya trading lewat Genesis API?
Tidak. Genesis API hanya menyajikan data. Order ditempatkan di exchange secara manual atau lewat API exchange itu sendiri dengan key-nya, dengan risiko Anda sendiri.