Genesis Arbitrage

Genesis Arbitrage · · 9 dk okuma

Genesis API anahtarı: nasıl alınır, nerede saklanır, nasıl yeniden oluşturulur ve iptal edilir

Kısaca

  • gns_live_… anahtarı profilinizde "Anahtar al" düğmesiyle oluşturulur ve yalnızca bir kez gösterilir. Biz yalnızca hash'ini saklarız; kaybolan anahtar geri getirilemez, yalnızca yeniden oluşturulabilir.
  • Anahtar, kendi sunucunuzdan X-API-Key başlığıyla gönderilir. Kod onu GENESIS_API_KEY ortam değişkeninden okur; anahtar asla istek URL'sine veya web sitesi koduna girmez.
  • Anahtar sızarsa "Yeniden oluştur"a tıklayın: eski anahtar hemen çalışmayı durdurur, siz de onu tüm programlarda değiştirirsiniz. Her hesaba bir anahtar verilir.

Genesis API için bir API anahtarı, parola gibi çalışan bir gns_live_… dizesidir: sunucu hesabınızı ve planınızı onunla tanır. Anahtarı her istekte X-API-Key HTTP başlığıyla gönderirsiniz; anahtar yoksa veya yanlışsa API 401 invalid_key döndürür. Her hesaba bir anahtar verilir; anahtarı Genesis Arbitrage profilinizde alır, yeniden oluşturur ve iptal edersiniz.

Anahtar nerede durur

Anahtarı profilinizde, "Genesis API" bloğunda yönetirsiniz; profilin diğer blokları hesap profili rehberinde anlatılır. Blok, API aboneliğinizi ve anahtarın durumunu gösterir:

Ne görüyorsunuzNe anlama geliyor
"Abonelik aktif değil", "Abone ol" düğmesiHenüz API planı yok; düğme planları açar
"Abonelik aktif", "… tarihine kadar aktif", "Yenile" düğmesiPlan bu tarihe kadar geçerli
"Aboneliğin süresi doldu", "Yenile" düğmesiSüre bitti: anahtar reddedilir ve yenileyene kadar anahtar düğmeleri gizlenir
"Henüz anahtar oluşturulmadı", "Anahtar al" düğmesiPlanınız var ama henüz anahtarınız yok
"API anahtarı" ve gns_live_…Etkin anahtarın başı; anahtarın tamamı bir daha gösterilmez
"oluşturuldu: …" · "kullanıldı: …"Anahtarın oluşturulma tarihi ve son istek yaptığı tarih
"Kullanılan çağrı", "istek/sn", "güncellik", "sıfırlanma: …"Kullanılan kota, saniyedeki istek limiti, veri gecikmesi ve sayacın sıfırlanma tarihi

Bloğun köşesindeki "Dokümantasyon" bağlantısı Genesis API dokümantasyonunu açar. Kota ve limitler Genesis API limitleri rehberinde açıklanır.

Anahtar nasıl alınır

  1. Bir API planına abone olun

    Genesis API fiyatları sayfasında Trial, Start, Pro veya Max planını ve bir süre seçin, "Abone ol"a tıklayın ve faturayı kriptoyla ödeyin. Profilinizdeki durum "Abonelik aktif" olur.

  2. "Anahtar al"a tıklayın

    Anahtarınız yokken düğme "Genesis API" bloğunda görünür. Anahtar hemen oluşturulur.

  3. Anahtarı "API anahtarınız" penceresinden kaydedin

    Pencere anahtarın tamamını bir kez gösterir. "Kopyala"ya tıklayın ve anahtarı bir parola yöneticisine ya da doğrudan sunucunuzun korumalı değişkenlerine koyun. "Tamam"dan sonra anahtarın tamamını bir daha göremezsiniz: yalnızca hash'ini saklarız.

  4. Anahtarı bir istekle deneyin

    Aşağıdaki örneklerdeki gibi /account/usage adresini çağırın. data.plan içinde planınızı gösteren bir 200 yanıtı, anahtarın kabul edildiği anlamına gelir.

Anahtar nasıl gönderilir

Anahtar yalnızca X-API-Key başlığında gönderilir. Sunucu anahtarı URL parametrelerinden veya Authorization başlığından okumaz ve 401 yanıtı verir. Örnekler anahtarı GENESIS_API_KEY ortam değişkeninden okur; temel URL https://api.genesisarbitrage.com/v1 adresidir.

curl:

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

requests kütüphanesiyle Python 3.10+:

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"])

Yerleşik fetch ile JavaScript, Node.js 18+:

// .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);

Üç istek de aynı yanıtı döndürür (örnek değerler):

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

Yanıt alanları dokümantasyonun Kullanım bölümünde anlatılır.

Anahtar nerede saklanır

Bir Genesis API anahtarı yalnızca veri okur: onunla alım satım yapamaz veya para çekemezsiniz. Sızıntının bedeli başka yerden gelir: başkalarının programları kotanızı ve saniyedeki istek limitinizi tüketir.

YerUygun muNeden
Sunucudaki ortam değişkeniEvetAnahtar koddan ve depodan uzak kalır
.gitignore içinde listelenen bir .env dosyasıEvetpython-dotenv (load_dotenv()) ve Node.js 20.6+ içinde node --env-file=.env ile yüklenir
Barındırma ve CI gizli değerleriEvetPlatform anahtarı programa başlangıçta verir; GitHub Actions'ta adımın env alanından geçirilen bir depo gizli değeri
Parola yöneticisiEvetİnsan için yedek kopya
İstek URL'siHayırURL'ler sunucu ve proxy günlüklerine ve tarayıcı geçmişine düşer
Web sitesi, eklenti veya mobil uygulama koduHayırSayfa kaynağını açan veya uygulamayı çözen herkes anahtarı görür
Herkese açık depoHayırDosya silinse bile anahtar commit geçmişinde kalır
Ekran görüntüleri, sohbetler, destek talepleriHayırMesajlar ve görseller başkalarına iletilir

Veri bir tarayıcıya ulaşacaksa, örneğin bir panel veya eklenti için, Genesis API'yi sunucunuz çağırır ve tarayıcı hazır sonucu sunucunuzdan alır. Destek için yanıttaki X-Request-Id, UTC cinsinden istek zamanı, endpoint ve durum gerekir; anahtar asla gerekmez. İşlem yetkisi olan borsa anahtarları daha risklidir; bunların nasıl kısıtlanacağı kripto borsa hesabınızı nasıl güvenceye alırsınız yazısında anlatılır.

Yeniden oluşturma ve iptal

DüğmeNe olurNe zaman kullanılır
"Yeniden oluştur"Eski anahtar hemen çalışmayı durdurur ve "API anahtarınız" penceresi yenisini gösterirAnahtar sızdı veya kayboldu ya da onu bilen biri ayrıldı
"İptal et"Anahtar yerine yenisi verilmeden kapatılır ve API erişimi kapanır; blok yine "Anahtar al" gösterirAnahtara artık ihtiyacınız yok

İki düğme de önce onay ister. İletişim kutularında "Anahtar yeniden oluşturulsun mu? Mevcut anahtar hemen çalışmayı durdurur." ve "Anahtar iptal edilsin mi? Anahtar hemen çalışmayı durdurur ve API erişimi kapanır." yazar; seçenekler "İptal" ve "Onayla"dır. Anahtar sızdıysa:

  1. Anahtarı yeniden oluşturun

    "Yeniden oluştur"a, ardından "Onayla"ya tıklayın ve yeni anahtarı "API anahtarınız" penceresinden kaydedin. O andan itibaren eski anahtarlı istekler 401 alır.

  2. Anahtarı tüm programlarda değiştirin

    Ortam değişkenlerini, .env dosyalarını ve CI ile barındırma gizli değerlerini güncelleyin, sonra programları yeniden başlatın: bir süreç ortamını başlangıçta okur. Bir program hâlâ eski anahtarı gönderiyorsa GENESIS_API_KEY değişkeninin ortamda zaten ayarlı olup olmadığına bakın: python-dotenv ve node --env-file, zaten ayarlı bir değişkeni .env içindeki değerle ezmez.

  3. Çağrı kullanımınızı kontrol edin

    Profilinizdeki "Kullanılan çağrı" satırı veya /account/usage isteği, bu dönemde kaç çağrı harcandığını gösterir. Yeniden oluşturma sayacı sıfırlamaz.

401 invalid_key: nelere bakılmalı

Anahtar yoksa, yanlışsa veya iptal edildiyse ya da abonelik bittiyse sunucu 401 ile invalid_key kodunu döndürür:

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

Başlık ulaştı ama anahtar reddedildiyse message olası tüm nedenleri birden sıralar. 403 plan_restricted yanıtı başka bir şeydir: anahtar kabul edilmiştir, ancak endpoint planınıza dahil değildir. Diğer kodlar dokümantasyonun Hatalar bölümünde ve Genesis API yanıtları ve hataları rehberinde yer alır.

Dokümantasyondaki "Deneyin" formu

Dokümantasyondaki her endpoint'in bir "Deneyin" formu vardır. Anahtarı "API anahtarınız (gns_live_…)" alanına yapıştırıp "İstek gönder"e tıklayın: durum kodu, yanıt süresi ve kısaltılmış bir yanıt formun altında görünür. Anahtar yalnızca tarayıcınızda saklanır ve API dışında hiçbir yere gönderilmez.

Tarayıcı anahtarı hatırlar ve bir sonraki ziyaretinizde alanı doldurur; bu yüzden formu başkasının bilgisayarında kullanmayın. Formdan giden istek normal bir API çağrısıdır: koddan gelen istek gibi kotayı ve saniyedeki istek limitini kullanır. Koddan ilk isteğiniz, yanıtın açıklamasıyla birlikte Genesis API hızlı başlangıç rehberindedir.

Sorular ve cevaplar

Her bot için ayrı bir anahtarım olabilir mi?

Hayır, her hesaba bir anahtar verilir. Onu kullanan tüm programlar çağrı kotasını ve saniyedeki istek limitini paylaşır. Limitler dar geliyorsa planınızı yükseltin: limitleri aşmak için birkaç hesap açmak kuralları ihlal eder.

Yeniden oluşturma çağrı sayacını sıfırlar mı?

Hayır. "Kullanılan çağrı" anahtara değil, hesabın aboneliğine aittir: yeni anahtar aynı 30 günlük dönemi sürdürür.

Başlığı küçük harfle, x-api-key olarak yazabilir miyim?

Evet. HTTP başlık adlarında büyük/küçük harf ayrımı yoktur; bu kural RFC 9110, bölüm 5.1 ile belirlenmiştir. Anahtarın kendisi değiştirilmeden gönderilmelidir.

Yeniledikten sonra yeni anahtar gerekir mi?

Hayır. Abonelik bittiği sürece anahtar 401 alır, "Yenile"den sonra aynı anahtar yeniden çalışır.