Genesis Arbitrage

Genesis Arbitrage · · Güncellenme · 6 dk okuma

Genesis API hızlı başlangıç: anahtar, ilk istek ve limitler

Kısaca

  • Genesis API, Genesis Arbitrage verilerine REST erişimidir: CEX ve DEX spreadleri, emir defterleri, fonlama, zincirler arası, zincir üstü akışlar, tahmin piyasaları ve Genesis AI+ sinyalleri.
  • İlk isteğe üç adımda ulaşılır: bir tarife, profilinizde bir anahtar ve X-API-Key başlıklı bir GET isteği.
  • Tarifeniz çağrı kotasını, saniyedeki istek sayısını ve veri gecikmesini belirler — Trial'da 60 saniyeden Max'te 5 saniyeye kadar.

Genesis API, Genesis Arbitrage verilerini bir REST API olarak sunar: CEX ve DEX arasındaki spreadler, emir defterleri, fonlama, zincirler arası, zincir üstü akışlar, tahmin piyasaları ve Genesis AI+ sinyalleri. Sitedeki her araç, tek bir JSON biçimiyle kendi uç noktası olarak kullanılabilir. İlk isteğiniz için bir API tarifesi, bir anahtar ve bir HTTP başlığı yeterlidir — SDK gerekmez, HTTP istemcisi olan her dil işe yarar.

Genesis API hızlı başlangıç: anahtar, ilk istek ve limitler
Genesis Arbitrage'de nasıl görünür

API neleri kapsar

Uç noktalar sitenin bölümlerini yansıtır:

Veri setleri Genesis API sayfasında anlatılır; her uç noktanın parametreleri ve alanları dokümantasyondadır.

Tarifeler ve limitler

API'nin site aboneliğinden ayrı kendi tarifeleri vardır: Trial, Start, Pro ve Max. Çağrı kotası, saniyedeki istek limiti ve veri tazeliği bakımından farklılaşırlar.

API tarifesiAylık çağrıVeri tazeliği
Trial500K60 sn
Start2M30 sn
Pro5M10 sn
Max10M5 sn

Trial ayda 20 $'dır ve Max saniyede 15 isteğe izin verir. Tarifenize dahil olmayan uç noktalar plan_restricted koduyla 403 hatası döndürür. Limitleri aşan istekler ücretlendirilmez: yeni dönemi bekleyin veya tarifenizi yükseltin. Kotayı yalnızca 200 yanıtları harcar: hatalar ve 304 yanıtları ücretsizdir. Fiyatlar ve tam karşılaştırma Genesis API Fiyatlandırma sayfasındadır.

İlk isteğiniz

  1. Bir tarife seçin

    Genesis API Fiyatlandırma sayfasında bir tarife ve dönem seçin ve "Abone ol"a tıklayın. Ödeme, site aboneliğinde olduğu gibi kripto ile yapılır. Başka bir API tarifesi zaten aktifse, yenisini ödemek onun yerine geçer ve kalan süre kaybolur — site sizi önceden uyarır.

  2. Anahtarınızı alın

    Profilinizde, Genesis API bloğunda "Anahtar al"a tıklayın. "API anahtarınız" penceresinde bir gns_live_… anahtarı görünür — "Kopyala"ya tıklayın ve kaydedin. Yalnızca bir kez gösterilir.

  3. Bir istek yapın

    Düz bir HTTP GET gönderin ve anahtarı X-API-Key başlığında iletin. Temel adres https://api.genesisarbitrage.com/v1. İlk uç nokta olarak /account/usage iyi bir seçimdir — tarifenizi ve kalan kotayı gösterir.

  4. Yanıtı ayrıştırın

    Başarılı bir yanıt tek bir zarf içinde gelir: bir data dizisi ve bir meta bloğu. Bir şeyler ters giderse aşağıdaki hata tablosuna bakın.

Bir curl örneği:

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

Dokümantasyonda bir "Dene" formu vardır: anahtarınızı yapıştırın, "İstek gönder"e tıklayın ve kısaltılmış bir yanıtı doğrudan sayfada görün. Anahtar yalnızca tarayıcınızda saklanır.

Yanıt biçimi

Hatalar ve limitler

KodAnlamı
401Anahtar eksik, geçersiz veya iptal edilmiş
403Uç nokta tarifenize dahil değil
404Uç nokta veya kaynak bulunamadı
429İstek limiti aşıldı — X-RateLimit ve Retry-After başlıklarına bakın
500Dahili hata, daha sonra tekrar deneyin
503Veriler yeniden oluşturuluyor, birkaç saniye sonra tekrar deneyin — Retry-After'a bakın

Her yanıttaki X-RateLimit başlıkları saniyedeki istek limitinizi, geçerli pencerede kaç isteğin kaldığını ve pencerenin ne zaman sıfırlandığını gösterir. X-Quota başlıkları dönem için çağrı kotasını, kalanını ve ne zaman sıfırlanacağını gösterir. Her yanıtta ayrıca bir X-Request-Id bulunur: destekle iletişime geçerken bunu, UTC cinsinden istek zamanını, uç noktayı ve durumu ekleyin. Anahtarın kendisini asla göndermeyin.

Sırada ne var

Sorular ve cevaplar

Genesis API ücretsiz borsa API'lerinden nasıl farklıdır?

Borsa API'leri tek bir platformun emir defterlerini ve ticker'larını döndürür. Genesis API ise onlarca borsa ve ağ genelinde hesaplanmış spreadleri, para yatırma ve çekme bayraklarını ve likiditesiz paritelerden arındırılmış verileri döndürür.

Limiti aşarsam ne olur?

Sunucu, X-RateLimit ve Retry-After başlıklarıyla 429 yanıtı verir. Fazla istekler ücretlendirilmez.

API tarifemi değiştirebilir miyim?

Evet. Yeni tarife ödemeden hemen sonra geçerli olur: yeni limitler ve tazelik anında uygulanır, çağrı kotası sıfırdan başlar, önceki tarifenin kalanı ise kaybolur. Aynı tarifeyi yenilemek mevcut süreye gün ekler.

Verileri kendi ürünümde kullanabilir miyim?

Evet, Genesis API üzerinde kendi servislerinizi, botlarınızı ve panolarınızı oluşturabilirsiniz. Ham verileri olduğu gibi yeniden satamazsınız.