Panduan cepat Genesis API: key, request pertama, dan batas
Ringkasan
- Genesis API adalah akses REST ke data Genesis Arbitrage: spread CEX dan DEX, order book, funding, cross-chain, aliran on-chain, prediction market, dan sinyal Genesis AI+.
- Untuk sampai ke request pertama cukup tiga langkah: paket, key di profil Anda, dan request GET dengan header X-API-Key.
- Paket Anda menentukan kuota panggilan, request per detik, dan jeda data — dari 60 detik di Trial hingga 5 detik di Max.
Genesis API menyajikan data Genesis Arbitrage sebagai REST API: spread antara CEX dan DEX, order book, funding, cross-chain, aliran on-chain, prediction market, dan sinyal Genesis AI+. Setiap alat di situs tersedia sebagai endpoint tersendiri dengan satu format JSON. Request pertama Anda hanya membutuhkan paket API, sebuah key, dan satu header HTTP — tanpa SDK, bahasa pemrograman apa pun dengan klien HTTP bisa dipakai.

Cakupan API
Endpoint-nya mencerminkan bagian-bagian situs:
- Arbitrase — Spot – Spot, Spot – Futures, Futures – Futures, DEX – Spot, DEX – Futures, Crosschain, dan Arbitrase Saham.
- Order book — harga eksekusi untuk suatu volume di setiap market, «Order-book Δ» untuk baris arbitrase, order book sebuah market, riwayat eksekusi, dan slippage DEX (pada paket API Pro dan Max).
- Prediction market — arbitrase prediksi dan status platform; analitik, smart money, transaksi besar, dan peringkat trader pada paket API Pro dan Max.
- Funding — funding rate di semua exchange, spread funding, dan analitik riwayat funding (pada paket API Pro dan Max).
- Market — Fair – Last, CEX Pumps – Dumps, DEX Dumps, Pelacakan OI.
- On-chain — transfer besar, aliran CEX, mint dan bridge, dompet tim, posisi Perp. DEX, unlock, klaim, peretasan; pada paket API Pro dan Max juga ikhtisar DEX, analitik, dan halaman koin.
- AI dan pencarian — sinyal Genesis AI+ dan kartu koin lengkap.
- Akun — status key Anda: paket, kuota terpakai, dan batas.
Kumpulan data dijelaskan di halaman Genesis API; parameter dan field setiap endpoint ada di dokumentasi.
Paket dan batas
API memiliki paket sendiri, terpisah dari langganan situs: Trial, Start, Pro, dan Max. Perbedaannya ada pada kuota panggilan, batas request per detik, dan kesegaran data.
| Paket API | Panggilan per bulan | Kesegaran data |
|---|---|---|
| Trial | 500K | 60 dtk |
| Start | 2 juta | 30 dtk |
| Pro | 5 juta | 10 dtk |
| Max | 10 juta | 5 dtk |
Trial berharga $20 per bulan, dan Max mengizinkan 15 request per detik. Endpoint yang bukan bagian dari paket Anda mengembalikan error 403 dengan kode plan_restricted. Request yang melebihi batas tidak dikenai biaya: tunggu periode baru atau tingkatkan paket. Kuota hanya dipakai oleh respons 200: error dan respons 304 gratis. Harga dan perbandingan lengkap ada di halaman Harga Genesis API.
Request pertama Anda
Pilih paket
Di halaman Harga Genesis API, pilih paket dan periode, lalu klik "Berlangganan". Pembayaran dilakukan dengan crypto, sama seperti langganan situs. Jika paket API lain masih aktif, membayar paket baru akan menggantikannya dan sisanya hangus — situs memperingatkan Anda terlebih dahulu.
Dapatkan key Anda
Di profil, pada blok Genesis API, klik "Dapatkan key". Key
gns_live_…muncul di jendela "API key Anda" — klik "Salin" dan simpan. Key hanya ditampilkan satu kali.Kirim request
Kirim HTTP GET biasa dan sertakan key di header
X-API-Key. Base URL-nyahttps://api.genesisarbitrage.com/v1. Endpoint pertama yang baik adalah/account/usage— endpoint ini menampilkan paket dan sisa kuota Anda.Baca responsnya
Respons yang berhasil datang dalam satu amplop: array
datadan blokmeta. Jika ada yang salah, periksa tabel error di bawah.
Contoh curl:
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_…"
Dokumentasi memiliki formulir "Coba sekarang": tempel key Anda, klik "Kirim request", dan lihat respons yang dipersingkat langsung di halaman. Key hanya disimpan di browser Anda.
Format respons
databerisi array atau objek, tergantung endpoint.metaberisi jumlah item, waktu pembaruan data terakhir, jeda paket Anda dalam detik, dan paket Anda.- Nilai kosong adalah
null. Waktu dalam detik unix. - Spread dan rate berupa persentase: 0,92 berarti 0,92%.
- Semua parameter filter bersifat opsional: tanpa parameter, endpoint mengembalikan seluruh kumpulan data.
Error dan batas
| Kode | Artinya |
|---|---|
| 401 | Key tidak ada, tidak valid, atau dicabut |
| 403 | Endpoint bukan bagian dari paket Anda |
| 404 | Endpoint atau resource tidak ditemukan |
| 429 | Batas laju terlampaui — lihat header X-RateLimit dan Retry-After |
| 500 | Error internal, coba lagi nanti |
| 503 | Data sedang dibangun ulang, coba lagi beberapa detik lagi — lihat Retry-After |
Header X-RateLimit di setiap respons menunjukkan batas request per detik Anda, berapa request tersisa di jendela saat ini, dan kapan jendela diatur ulang. Header X-Quota menunjukkan kuota panggilan untuk periode ini, sisanya, dan kapan kuota diatur ulang. Setiap respons juga membawa X-Request-Id: saat menghubungi dukungan, sertakan ID itu bersama waktu request dalam UTC, endpoint, dan status. Jangan pernah mengirim key itu sendiri.
Langkah berikutnya
- API key: mendapatkan, menyimpan, membuat ulang — di mana key berada di profil dan cara melindunginya.
- Batas: kuota, request per detik, kesegaran data — cara menghindari respons 429.
- Respons dan error: JSON, ETag, kode HTTP — amplop respons, 304, dan percobaan ulang.
- Endpoint per kelompok: arbitrase, order book, funding, market dan sinyal AI, on-chain, prediction market dan surebet.
- Genesis API untuk agen AI — spesifikasi OpenAPI, llms.txt, dan function calling.
Tanya jawab
Apa bedanya Genesis API dengan API exchange yang gratis?
API exchange mengembalikan order book dan ticker dari satu platform. Genesis API mengembalikan spread terhitung di puluhan exchange dan jaringan, flag deposit dan penarikan, serta data yang sudah dibersihkan dari pasangan yang tidak likuid.
Apa yang terjadi jika saya melebihi batas?
Server merespons dengan 429 beserta header X-RateLimit dan Retry-After. Request tambahan tidak dikenai biaya.
Bisakah saya mengganti paket API?
Bisa. Paket baru berlaku tepat setelah pembayaran: batas dan kesegaran data yang baru langsung diterapkan, kuota panggilan dihitung dari nol, dan sisa paket sebelumnya hangus. Memperpanjang paket yang sama menambah hari ke masa berlaku saat ini.
Bisakah saya memakai data ini di produk saya sendiri?
Bisa, Anda dapat membangun layanan, bot, dan dashboard sendiri di atas Genesis API. Anda tidak boleh menjual kembali data mentah apa adanya.