Kripto API nedir ve neleri otomatikleştirebilirsiniz
Kısaca
- Kripto API, programınızın piyasa verisi istemek ve JSON yanıt almak için kullandığı programlama arayüzüdür: sitedeki tabloda gördüğünüz spread,
exchange_buy,exchange_sellvespread_pctalanları olarak gelir. - Borsa API'si tek bir borsanın verisini ve hesabını kapsar, piyasa verisi API'si birçok borsayı tek biçimde toplar, zincir üstü API ise blokzinciri okur. Genesis API salt okunur bir piyasa verisi API'sidir.
- API ile trader'lar spread, fonlama ve açık pozisyon takibini, uyarıları, sinyal günlüğünü, panelleri ve geçmiş veri araştırmasını otomatikleştirir.
- Deneyim yoksa işlem açmayı ve para çekmeyi elle yapın: veri anlık görüntüleri borsanın gerisinde kalır, koddaki hata ise her döngüde tekrarlanır.
Kripto API, kodunuzun kripto piyasa verisini istemek ve üzerinde çalışabileceği bir yanıt almak için kullandığı programlama arayüzüdür: fiyatlar, borsalar arası spread'ler, fonlama oranları, açık pozisyon. İnsan bu sayıları tabloda okur; program ise JSON alanları olarak alır, bir eşikle karşılaştırabilir, günlüğe yazabilir ya da hemen uyarı gönderebilir. Genel tanım sözlükteki API maddesinde.
İstek ve yanıt
API ile çalışmak iki mesajın alışverişidir: programınız bir adrese istek gönderir, sunucu yanıt döndürür. En kısa örnek, anahtar gerektirmeyen Genesis API durum kontrolüdür:
curl "https://api.genesisarbitrage.com/health"
{"ok":true}
curl, HTTP istekleri için komut satırı programıdır; kurulu olup olmadığını curl --version gösterir. Veri istekleri için API anahtarı gerekir: sunucunun hesabınızı ve planınızı tanımak için kullandığı bir dizedir. Örnek: FUEL coini için Spot – Spot çiftleri, anahtar GENESIS_API_KEY ortam değişkeninden alınıyor:
URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
"success": true,
"data": [
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"spread_pct": 0.11,
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
…
}
],
"meta": {
"count": 1,
"updated_at": 1794675861,
"freshness_sec": 60,
"plan": "trial"
}
}
Yanıtta tek bir çift var: FUEL'u ByBit'ten 0,0007029'dan alıp Gate'te 0,0007037'den satmak. Spread spread_pct içinde hazır hesaplanmış: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ %0,11. withdraw_enabled_buy ve deposit_enabled_sell bayrakları ByBit'ten para çekmenin ve Gate'e para yatırmanın açık olduğunu gösterir, meta.updated_at ise anlık görüntünün ne zaman oluşturulduğunu söyler. Spot – Spot tablosu aynı sayıları gösterir, her alan dokümantasyonun Spot — Spot bölümünde açıklanır.
İstek adresi bir temel URL'den, bir endpoint yolundan ve parametrelerden oluşur; anahtar ise ayrıca X-API-Key başlığıyla gider. Ders 2 isteğin her parçasını ayrı ayrı ele alır, durum kodlarını ve JSON okumayı anlatır, anahtar değişkeninin nasıl tanımlanacağını gösterir.
İstek ve ardından veri anlık görüntüsü içeren yanıttan oluşan bu alışverişe REST API denir. Yeni veriyi isteği yeniden göndererek alırsınız: Genesis API çıktısını her meta.freshness_sec saniyede bir yeniler; Trial'da 60, Max'ta 5 saniyedir. Borsalar ikinci bir kanal da sunar, WebSocket: bağlantı açık kalır, sunucu işlemleri ve emir defteri değişikliklerini oluştukları anda gönderir; Binance akışları buna örnektir. Genesis API'de WebSocket yoktur.
Kripto API türleri
Kripto API'ler verinin nereden geldiği ve onlarla neler yapabileceğiniz bakımından farklıdır:
- Borsa API'si: tek bir borsanın verisi ve hesabına erişim. Borsa fiyatları, emir defterlerini ve işlemleri herkese açık sunar; bakiyeler, emirler ve işlem geçmişi ise anahtar ve imzalı istek ister. Binance bunu güvenlik türleri olarak ayırır: açık piyasa verisi için
NONE, emir verme ve iptal içinTRADE, hesap bilgileri içinUSER_DATA(Binance dokümanları). - Piyasa verisi API'si: birçok borsa ve ağ tek biçimde. Borsaların birleştirilmesini gerektiren verileri sunar: borsalar arası spread'ler, tek döneme normalize edilmiş fonlama oranları, borsa bazında açık pozisyon. Genesis API bu türdendir ve yalnızca veri okur.
- Zincir üstü API: işlemler, token transferleri ve adres bakiyeleri gibi blokzincir verisi. "Borsa", "proje ekibi" veya "balina" gibi etiketler, ağ verisinin üzerine kurulu analitik servislerden gelir.
Altı API türünün karşılaştırması, REST ile WebSocket farkı ve dokuz maddelik seçim kontrol listesi kripto API türleri ve nasıl seçilir incelemesinde.
Trader neleri otomatikleştirebilir
Sabit bir kuralla tekrarladığınız işi otomatikleştirin: tabloyu açmak, sayıyı eşikle karşılaştırmak, sonucu not etmek. Program bunu belirli aralıklarla yapar ve gece saatlerini atlamaz.
| Görev | Program ne yapar | Genesis API verisi |
|---|---|---|
| Spread takibi | Para yatırma ve çekmenin açık olduğu, eşiğin üzerindeki çiftler | /arbitrage/spot-spot, /arbitrage/spot-futures |
| Fonlama | 8 saate normalize edilmiş borsa oranlarını karşılaştırır | /funding/rates, /funding/spread |
| Açık pozisyon | 5 dakika ile 1 saat arasındaki ani OI değişimlerini yakalar | /market/open-interest |
| Uyarılar | Koşul sağlandığında Telegram'dan mesaj gönderir | Herhangi bir veri endpoint'i |
| Günlük | Bulduğu her çifti zaman damgasıyla kaydeder | Yanıt ve meta.updated_at |
| Panel | Kendi sütunlarınızı ve eşiklerinizi kendi sayfanızda gösterir | Sunucunuzdan giden istekler |
| Geçmiş araştırması | Geçmiş verilerde örüntü arar | /funding/analytics/daily (Pro, Max) |
Uyarılar sık görülen ilk projedir: program bir endpoint'i en fazla meta.freshness_sec sıklığında sorgular ve spread ya da oran eşiğinizi aştığında size mesaj yazar. Kod yazmadan benzer sinyaller, sitedeki Pro planın Genesis Arbitrage Telegram uyarılarından gelir.
Günlük, henüz para riske atılmadan bir fikri sınar. Örnek: bir bot 30 saniyede bir spread'i %1 ve üzeri olan çiftleri kaydediyor; günde 86.400 / 30 = 2.880 anlık görüntü eder. Bunlar kaç çiftin bir dakikadan uzun sürdüğünü ve kaçının bir sonraki sorguda kapanmış olduğunu gösterir.
Geçmiş için Genesis API, 13 borsada günlük gerçekleşen fonlama toplamlarını bir yıla kadar sunan fonlama analitiğini ve emir defteri slipaj geçmişini sunar; ikisi de Pro ve Max planlarındadır. Genesis API'de geçmiş mum verisi yoktur: onu borsa API'leri verir; Binance'te GET /api/v3/klines ile istek başına en fazla 1.000 mum (Binance dokümanları). Borsalar arası spread geçmişini programınız kendi günlüğündeki anlık görüntülerden kendisi oluşturur.
Deneyim olmadan otomatikleştirilmemesi gerekenler
İki işlem yanlış gittiğinde pahalıya patlar: işlem açma ve para çekme.
İşlem açma
Borsanın işlem API'si üzerinden emir veren bir bot, çalıştığı sıklıkta hata yapar: giriş koşulundaki bir hata ve 10 saniyede bir sorgulama, saatte 3.600 / 10 = 360 emir üretir. Veri de gecikir: Genesis API anlık görüntüsü plana göre 60 ile 5 saniyede bir yenilenir, emir defterleri borsanın 5–20 saniye gerisinde kalır ve spread bu sürede kapanabilir. Genesis API emir vermez: çiftleri bulur, işlemi borsada kendiniz açarsınız.
Para çekme
Para çekme yetkisi olan bir borsa anahtarı, onu ele geçiren herkesin hesaptaki fonları taşımasına izin verir; bu yüzden böyle bir anahtarın sızması tüm bakiyeye mal olabilir. Veri okuyan ya da işlem yapan botların bu yetkiye ihtiyacı yoktur. Binance'te yeni bir API anahtarı varsayılan olarak işlem bile yapamaz: işlem yetkisi ayrıca açılır.
Site, borsa API'leri veya Genesis API
| Görev | Daha uygun olan | Neden |
|---|---|---|
| Çiftlere ve grafiklere göz atmak | Genesis Arbitrage sitesi | Tablolar ve filtreler, kod yok |
| Programlamadan sinyal | Sitedeki Telegram uyarıları | Eşikler arayüzden ayarlanır |
| 20'den fazla borsada kendi kurallarınız | Genesis API | Spread'ler hesaplanmış, tek biçim |
| Emirler, bakiyeler, para çekme | Borsa API'si | Emri yalnızca borsa kabul eder |
| Her işlem gerçek zamanlı | Borsa WebSocket'i | Genesis API her 60–5 sn'de anlık görüntü sunar |
| Geçmiş mumlar | Borsa API'si | Genesis API'de mum yok |
| 13 borsada fonlama geçmişi | Genesis API, Pro ve Max | Bir yıla kadar günlük toplam, tek biçim |
Başlamak için pratik bir kurgu: Genesis API bir çift bulur, botunuz uyarı gönderir, emir defterini borsada kontrol edip işlemi kendiniz açarsınız. Genesis API planları ayda 20 $'lık Trial'dan (500K çağrı, 60 sn güncellik) 200 $'lık Max'a (10M çağrı, 5 sn) kadar uzanır; ücretsiz plan yoktur. Planları Genesis API fiyatları sayfasında karşılaştırın.
Kursun devamı için neler gerekecek
- Genesis API anahtarı: fiyat sayfasında bir plan seçin ve anahtarı profilinizdeki "Anahtar al" düğmesiyle alın; adımlar Genesis API hızlı başlangıç sayfasında. Anahtarı
GENESIS_API_KEYortam değişkeninde tutun, istek URL'sine asla koymayın. - İlk istekleriniz için terminalde curl.
- 2. ve 4. derslerdeki betikler için Python 3.10+ ve
requestskütüphanesi (pip install requests). - Genesis API dokümantasyonu: her endpoint'in parametreleri, alanları, bir curl örneği ve isteği doğrudan sayfadan gönderen bir "Deneyin" formu vardır.
Dersler birbirinin üzerine kurulur:
- ders 2: ilk istek; adres, başlıklar, durum kodları ve JSON;
- ders 3: hangi veri hangi kararlara hizmet eder, spread'lerden ve emir defterlerinden fonlamaya ve zincir üstü akışlara;
- ders 4: Python ile spread ve fonlama monitörü;
- ders 5: eski veri, hatalar, anahtarlar ve AI ajanları dahil otomasyon riskleri.
Kendiniz deneyin
Anahtarsız istek gönderin
Terminalde
curl "https://api.genesisarbitrage.com/health"komutunu çalıştırın.{"ok":true}yanıtı, isteğin ulaştığı ve sunucunun JSON ile cevap verdiği anlamına gelir.Tabloyu alanlarla eşleştirin
Spot – Spot tablosunu ve Spot — Spot dokümantasyon bölümünü açın. Borsalar, fiyatlar, spread ve transfer durumu alanlarını bulun:
exchange_buy,price_sell,spread_pct,withdraw_enabled_buy.Rutin işlerinizi sıralayın
Her gün yaptığınız üç işi alın ve yukarıdaki tabloyla işaretleyin: site, Genesis API veya borsa API'si.
Bir iş için endpoint bulun
Genesis API ile yapılacak bir iş için dokümantasyonda endpoint'i bulun ve ihtiyaç duyduğunuz parametreleri, örneğin
coinvemin_spread, not edin. Bu isteği ders 2'de göndereceksiniz.