Genesis Arbitrage

Genesis Arbitrage · · 9 menit baca

API key Genesis API: cara mendapatkan, tempat menyimpan, cara membuat ulang dan mencabutnya

Ringkasan

  • Key gns_live_… dibuat di profil Anda dengan tombol "Dapatkan key" dan hanya ditampilkan sekali. Kami hanya menyimpan hash-nya, jadi key yang hilang tidak bisa dipulihkan, hanya bisa dibuat ulang.
  • Key dikirim lewat header X-API-Key dari server Anda sendiri. Kode membacanya dari variabel lingkungan GENESIS_API_KEY; key tidak pernah masuk ke URL request atau kode situs web.
  • Jika key bocor, klik "Buat ulang": key lama langsung tidak berlaku, lalu Anda menggantinya di setiap program. Setiap akun mendapat satu key.

API key untuk Genesis API adalah string gns_live_… yang berfungsi seperti kata sandi: server memakainya untuk mengenali akun dan paket Anda. Key dikirim di setiap request lewat header HTTP X-API-Key; tanpa key, atau dengan key yang salah, API mengembalikan 401 invalid_key. Setiap akun mendapat satu key, dan Anda mendapatkan, membuat ulang, serta mencabutnya di profil Genesis Arbitrage Anda.

Di mana key berada

Key dikelola di profil Anda, pada blok "Genesis API"; blok profil lainnya dibahas di panduan profil akun. Blok ini menampilkan langganan API dan status key:

Yang Anda lihatArtinya
"Langganan tidak aktif", tombol "Berlangganan"Belum ada paket API; tombol membuka daftar paket
"Langganan aktif", "Aktif hingga …", tombol "Perpanjang"Paket berjalan sampai tanggal itu
"Langganan berakhir", tombol "Perpanjang"Masa berlaku habis: key ditolak dan tombol key disembunyikan sampai Anda memperpanjang
"Key belum dibuat", tombol "Dapatkan key"Paket sudah ada, tetapi key belum
"API key" dan gns_live_…Awal key aktif; key lengkap tidak pernah ditampilkan lagi
"dibuat …" · "dipakai …"Kapan key dibuat dan kapan terakhir kali dipakai untuk request
"Panggilan terpakai", "req/dtk", "kesegaran data", "reset …"Kuota terpakai, batas request per detik, delay data, dan tanggal counter direset

Tautan "Dokumentasi" di sudut blok membuka dokumentasi Genesis API. Kuota dan batas dijelaskan di panduan batas Genesis API.

Cara mendapatkan key

  1. Berlangganan paket API

    Di halaman harga Genesis API, pilih Trial, Start, Pro, atau Max beserta periodenya, klik "Berlangganan", lalu bayar invoice dengan crypto. Status di profil Anda berubah menjadi "Langganan aktif".

  2. Klik "Dapatkan key"

    Tombol ini muncul di blok "Genesis API" selama Anda belum punya key. Key langsung dibuat.

  3. Simpan key dari jendela "API key Anda"

    Jendela ini menampilkan key lengkap satu kali. Klik "Salin" lalu simpan key di password manager atau langsung di variabel server yang terlindungi. Setelah "Selesai", key lengkap tidak bisa dilihat lagi: kami hanya menyimpan hash-nya.

  4. Uji key dengan sebuah request

    Panggil /account/usage seperti pada contoh di bawah. Respons 200 dengan paket Anda di data.plan berarti key diterima.

Cara mengirim key

Key dikirim hanya lewat header X-API-Key. Server tidak membaca key dari parameter URL maupun dari header Authorization, dan menjawab 401. Contoh membaca key dari variabel lingkungan GENESIS_API_KEY; base URL-nya https://api.genesisarbitrage.com/v1.

curl:

# the key comes from an environment variable
curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: $GENESIS_API_KEY"

Python 3.10+ dengan library requests:

import os

import requests

# os.environ[...] fails right away if the variable is not set
key = os.environ["GENESIS_API_KEY"]

r = requests.get(
    "https://api.genesisarbitrage.com/v1/account/usage",
    headers={"X-API-Key": key},
    timeout=10,
)
r.raise_for_status()
print(r.json()["data"]["plan"])

JavaScript, Node.js 18+ dengan fetch bawaan:

// .mjs file: modules allow top-level await
const key = process.env.GENESIS_API_KEY;
if (!key) throw new Error('GENESIS_API_KEY is not set');

const res = await fetch(
  'https://api.genesisarbitrage.com/v1/account/usage',
  { headers: { 'X-API-Key': key } },
);
const body = await res.json();
console.log(res.status, body.data?.plan);

Ketiga request mengembalikan respons yang sama (nilai sebagai ilustrasi):

{
  "success": true,
  "data": {
    "plan": "pro",
    "calls_used": 184201,
    "calls_limit": 5000000,
    "rps_limit": 5,
    "freshness_sec": 10,
    "period_resets_at": 1786492800
  },
  "meta": { … }
}

Field respons dijelaskan di bagian Usage pada dokumentasi.

Tempat menyimpan key

API key Genesis API hanya membaca data: dengan key ini Anda tidak bisa trading atau menarik dana. Kebocoran merugikan Anda dengan cara lain: program orang lain menghabiskan kuota dan batas request per detik Anda.

TempatBolehAlasan
Variabel lingkungan di serverYaKey tetap di luar kode dan repositori
File .env yang terdaftar di .gitignoreYaDimuat oleh python-dotenv (load_dotenv()) dan node --env-file=.env di Node.js 20.6+
Secret hosting dan CIYaPlatform memberikan key ke program saat start; di GitHub Actions, secret repositori yang diteruskan lewat env pada step
Password managerYaSalinan cadangan untuk manusia
URL requestTidakURL masuk ke log server dan proxy serta riwayat browser
Kode situs web, ekstensi, atau aplikasi selulerTidakSiapa pun yang membuka source halaman atau membongkar aplikasi bisa melihat key
Repositori publikTidakKey tetap ada di riwayat commit meski file dihapus
Screenshot, chat, tiket dukunganTidakPesan dan gambar bisa diteruskan

Jika data harus sampai ke browser, misalnya untuk dasbor atau ekstensi, server Anda yang memanggil Genesis API dan browser menerima hasil jadinya dari server Anda. Dukungan membutuhkan X-Request-Id dari respons, waktu request dalam UTC, endpoint, dan status, bukan key. Key exchange dengan hak trading lebih berisiko; cara membatasinya dibahas di cara mengamankan akun exchange crypto Anda.

Membuat ulang dan mencabut

TombolYang terjadiKapan dipakai
"Buat ulang"Key lama langsung tidak berlaku, dan jendela "API key Anda" menampilkan key baruKey bocor atau hilang, atau orang yang memegangnya sudah pergi
"Cabut"Key dimatikan tanpa pengganti dan akses API ditutup; blok kembali menampilkan "Dapatkan key"Anda tidak lagi memerlukan key

Kedua tombol meminta konfirmasi lebih dulu. Dialognya berbunyi "Buat ulang key? Key saat ini langsung tidak berlaku." dan "Cabut key? Key langsung tidak berlaku dan akses API ditutup." dengan pilihan "Batal" dan "Konfirmasi". Jika key bocor:

  1. Buat ulang key

    Klik "Buat ulang", lalu "Konfirmasi", dan simpan key baru dari jendela "API key Anda". Sejak saat itu request dengan key lama mendapat 401.

  2. Ganti key di setiap program

    Perbarui variabel lingkungan, file .env, serta secret CI dan hosting, lalu restart programnya: proses membaca lingkungannya saat start. Jika sebuah program masih mengirim key lama, periksa apakah GENESIS_API_KEY sudah diatur di lingkungan: python-dotenv dan node --env-file tidak menimpa variabel yang sudah diatur dengan nilai dari .env.

  3. Periksa pemakaian panggilan

    Baris "Panggilan terpakai" di profil Anda atau request ke /account/usage menunjukkan berapa panggilan yang terpakai pada periode ini. Membuat ulang key tidak mereset counter.

401 invalid_key: yang perlu diperiksa

Server menjawab 401 dengan kode invalid_key jika key tidak ada, salah, atau sudah dicabut, atau jika langganan telah berakhir:

{
  "success": false,
  "error": {
    "code": "invalid_key",
    "message": "Missing X-API-Key header."
  }
}

Jika header sampai tetapi key ditolak, message mencantumkan semua kemungkinan penyebab sekaligus. Respons 403 plan_restricted berarti hal lain: key diterima, tetapi endpoint tidak termasuk dalam paket Anda. Kode lain ada di bagian Errors dan di panduan respons dan error Genesis API.

Form "Coba sekarang" di dokumentasi

Setiap endpoint di dokumentasi memiliki form "Coba sekarang". Tempel key ke kolom "API key Anda (gns_live_…)" lalu klik "Kirim request": kode status, waktu respons, dan respons yang dipotong muncul di bawah form. Key hanya disimpan di browser Anda dan tidak dikirim ke mana pun selain API.

Browser mengingat key dan mengisi kolom pada kunjungan berikutnya, jadi jangan pakai form ini di komputer orang lain. Request dari form adalah panggilan API biasa: ia memakai kuota dan batas request per detik sama seperti request dari kode. Request pertama Anda dari kode, lengkap dengan penjelasan respons, ada di panduan cepat Genesis API.

Tanya jawab

Bisakah saya punya key terpisah untuk setiap bot?

Tidak, setiap akun mendapat satu key. Semua program yang memakainya berbagi kuota panggilan dan batas request per detik. Jika batasnya terlalu ketat, upgrade paket Anda: membuka beberapa akun untuk menyiasati batas melanggar aturan.

Apakah membuat ulang key mereset counter panggilan?

Tidak. "Panggilan terpakai" milik langganan akun, bukan key: key baru melanjutkan periode 30 hari yang sama.

Bolehkah menulis header dengan huruf kecil, x-api-key?

Ya. Nama header HTTP tidak peka huruf besar-kecil, aturan yang ditetapkan RFC 9110, bagian 5.1. Key itu sendiri harus dikirim tanpa diubah.

Apakah saya perlu key baru setelah memperpanjang?

Tidak. Selama langganan berakhir, key mendapat 401, dan setelah "Perpanjang" key yang sama berfungsi lagi.