Genesis Arbitrage

Genesis Arbitrage · · Diperbarui · 6 menit baca

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.

Panduan cepat Genesis API: key, request pertama, dan batas
Tampilan di Genesis Arbitrage

Cakupan API

Endpoint-nya mencerminkan bagian-bagian situs:

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 APIPanggilan per bulanKesegaran data
Trial500K60 dtk
Start2 juta30 dtk
Pro5 juta10 dtk
Max10 juta5 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

  1. 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.

  2. 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.

  3. Kirim request

    Kirim HTTP GET biasa dan sertakan key di header X-API-Key. Base URL-nya https://api.genesisarbitrage.com/v1. Endpoint pertama yang baik adalah /account/usage — endpoint ini menampilkan paket dan sisa kuota Anda.

  4. Baca responsnya

    Respons yang berhasil datang dalam satu amplop: array data dan blok meta. 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

Error dan batas

KodeArtinya
401Key tidak ada, tidak valid, atau dicabut
403Endpoint bukan bagian dari paket Anda
404Endpoint atau resource tidak ditemukan
429Batas laju terlampaui — lihat header X-RateLimit dan Retry-After
500Error internal, coba lagi nanti
503Data 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

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.