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.

API neleri kapsar
Uç noktalar sitenin bölümlerini yansıtır:
- Arbitraj — Spot – Spot, Spot – Futures, Futures – Futures, DEX – Spot, DEX – Futures, Crosschain ve Hisse Arbitrajı.
- Emir defterleri — her piyasada bir hacim için gerçekleşme fiyatları, arbitraj satırları için «Emir defteri Δ», bir piyasanın emir defteri, gerçekleşme geçmişi ve DEX kayması (API Pro ve Max tarifelerinde).
- Tahmin piyasaları — tahmin arbitrajı ve platform durumu; analitik, akıllı para, büyük işlemler ve trader sıralaması API Pro ve Max tarifelerinde.
- Fonlama — tüm borsalardaki fonlama oranları, fonlama spreadi ve geçmiş fonlama analitiği (API Pro ve Max tarifelerinde).
- Piyasa — Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Takibi.
- Zincir üstü — büyük transferler, CEX akışları, mint ve köprüler, ekip cüzdanları, Perp. DEX pozisyonları, kilit açılımları, claim'ler, hack'ler; API Pro ve Max tarifelerinde ayrıca DEX genel bakışı, analitik ve coin sayfası.
- Yapay zekâ ve arama — Genesis AI+ sinyalleri ve tam coin kartı.
- Hesap — anahtarınızın durumu: tarife, kullanılan kota ve limitler.
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 tarifesi | Aylık çağrı | Veri tazeliği |
|---|---|---|
| Trial | 500K | 60 sn |
| Start | 2M | 30 sn |
| Pro | 5M | 10 sn |
| Max | 10M | 5 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
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.
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.Bir istek yapın
Düz bir HTTP GET gönderin ve anahtarı
X-API-Keybaşlığında iletin. Temel adreshttps://api.genesisarbitrage.com/v1. İlk uç nokta olarak/account/usageiyi bir seçimdir — tarifenizi ve kalan kotayı gösterir.Yanıtı ayrıştırın
Başarılı bir yanıt tek bir zarf içinde gelir: bir
datadizisi ve birmetabloğ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
data, uç noktaya göre bir dizi veya bir nesne içerir.meta; öğe sayısını, verinin son güncellenme zamanını, tarifeniz için gecikmeyi saniye olarak ve tarifenizi içerir.- Boş değerler
null'dır. Zamanlar unix saniyesidir. - Spreadler ve oranlar yüzdedir: 0,92, %0,92 demektir.
- Tüm filtre parametreleri isteğe bağlıdır: onlar olmadan bir uç nokta tam veri setini döndürür.
Hatalar ve limitler
| Kod | Anlamı |
|---|---|
| 401 | Anahtar eksik, geçersiz veya iptal edilmiş |
| 403 | Uç nokta tarifenize dahil değil |
| 404 | Uç nokta veya kaynak bulunamadı |
| 429 | İstek limiti aşıldı — X-RateLimit ve Retry-After başlıklarına bakın |
| 500 | Dahili hata, daha sonra tekrar deneyin |
| 503 | Veriler 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
- API anahtarı: alma, saklama, yeniden oluşturma — anahtarın profilde nerede durduğu ve nasıl korunacağı.
- Limitler: kota, saniyedeki istek, tazelik — 429 yanıtlarından nasıl uzak durulur.
- Yanıtlar ve hatalar: JSON, ETag, HTTP kodları — yanıt zarfı, 304 ve yeniden denemeler.
- Gruplara göre uç noktalar: arbitraj, emir defterleri, fonlama, piyasa ve yapay zekâ sinyalleri, zincir üstü, tahmin piyasaları ve surebet'ler.
- Yapay zekâ ajanları için Genesis API — OpenAPI şeması, llms.txt ve function calling.
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.