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-Keybaşlığıyla gönderilir. Kod onuGENESIS_API_KEYortam 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üyorsunuz | Ne anlama geliyor |
|---|---|
| "Abonelik aktif değil", "Abone ol" düğmesi | Henüz API planı yok; düğme planları açar |
| "Abonelik aktif", "… tarihine kadar aktif", "Yenile" düğmesi | Plan bu tarihe kadar geçerli |
| "Aboneliğin süresi doldu", "Yenile" düğmesi | Süre bitti: anahtar reddedilir ve yenileyene kadar anahtar düğmeleri gizlenir |
| "Henüz anahtar oluşturulmadı", "Anahtar al" düğmesi | Planı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
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.
"Anahtar al"a tıklayın
Anahtarınız yokken düğme "Genesis API" bloğunda görünür. Anahtar hemen oluşturulur.
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.
Anahtarı bir istekle deneyin
Aşağıdaki örneklerdeki gibi
/account/usageadresini çağırın.data.planiçinde planınızı gösteren bir200yanı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.
| Yer | Uygun mu | Neden |
|---|---|---|
| Sunucudaki ortam değişkeni | Evet | Anahtar koddan ve depodan uzak kalır |
.gitignore içinde listelenen bir .env dosyası | Evet | python-dotenv (load_dotenv()) ve Node.js 20.6+ içinde node --env-file=.env ile yüklenir |
| Barındırma ve CI gizli değerleri | Evet | Platform anahtarı programa başlangıçta verir; GitHub Actions'ta adımın env alanından geçirilen bir depo gizli değeri |
| Parola yöneticisi | Evet | İnsan için yedek kopya |
| İstek URL'si | Hayır | URL'ler sunucu ve proxy günlüklerine ve tarayıcı geçmişine düşer |
| Web sitesi, eklenti veya mobil uygulama kodu | Hayır | Sayfa kaynağını açan veya uygulamayı çözen herkes anahtarı görür |
| Herkese açık depo | Hayır | Dosya silinse bile anahtar commit geçmişinde kalır |
| Ekran görüntüleri, sohbetler, destek talepleri | Hayır | Mesajlar 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üğme | Ne olur | Ne zaman kullanılır |
|---|---|---|
| "Yeniden oluştur" | Eski anahtar hemen çalışmayı durdurur ve "API anahtarınız" penceresi yenisini gösterir | Anahtar 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österir | Anahtara 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:
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
401alır.Anahtarı tüm programlarda değiştirin
Ortam değişkenlerini,
.envdosyaları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önderiyorsaGENESIS_API_KEYdeğişkeninin ortamda zaten ayarlı olup olmadığına bakın: python-dotenv venode --env-file, zaten ayarlı bir değişkeni.enviçindeki değerle ezmez.Çağrı kullanımınızı kontrol edin
Profilinizdeki "Kullanılan çağrı" satırı veya
/account/usageisteğ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şmadı. "Missing X-API-Key header." isteğin hiç anahtar taşımadığı anlamına gelir. Başlık adını ve değişkenin programın çalıştığı yerde ayarlı olup olmadığını kontrol edin: sunucuda, kapsayıcıda, zamanlanmış görevde.
- Anahtar bozulmuş. Fazladan bir boşluk, değerin içinde tırnak veya kesilmiş bir son
401verir: anahtar karakter karakter aynı olmalıdır. - Anahtar yeniden oluşturuldu veya iptal edildi. Programınızdaki anahtarın başını profilinizde "API anahtarı" altında görünen başla karşılaştırın.
- Abonelik bitti. Profilinizde "Aboneliğin süresi doldu" yazar. "Yenile"den sonra aynı anahtar yeniden çalışır; yeniden oluşturmanız gerekmez.
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.