Genesis Arbitrage

Genesis Arbitrage · · 9 dk okuma

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_sell ve spread_pct alanları 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:

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örevProgram ne yaparGenesis API verisi
Spread takibiPara yatırma ve çekmenin açık olduğu, eşiğin üzerindeki çiftler/arbitrage/spot-spot, /arbitrage/spot-futures
Fonlama8 saate normalize edilmiş borsa oranlarını karşılaştırır/funding/rates, /funding/spread
Açık pozisyon5 dakika ile 1 saat arasındaki ani OI değişimlerini yakalar/market/open-interest
UyarılarKoşul sağlandığında Telegram'dan mesaj gönderirHerhangi bir veri endpoint'i
GünlükBulduğu her çifti zaman damgasıyla kaydederYanıt ve meta.updated_at
PanelKendi sütunlarınızı ve eşiklerinizi kendi sayfanızda gösterirSunucunuzdan 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örevDaha uygun olanNeden
Çiftlere ve grafiklere göz atmakGenesis Arbitrage sitesiTablolar ve filtreler, kod yok
Programlamadan sinyalSitedeki Telegram uyarılarıEşikler arayüzden ayarlanır
20'den fazla borsada kendi kurallarınızGenesis APISpread'ler hesaplanmış, tek biçim
Emirler, bakiyeler, para çekmeBorsa API'siEmri yalnızca borsa kabul eder
Her işlem gerçek zamanlıBorsa WebSocket'iGenesis API her 60–5 sn'de anlık görüntü sunar
Geçmiş mumlarBorsa API'siGenesis API'de mum yok
13 borsada fonlama geçmişiGenesis API, Pro ve MaxBir 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

Dersler birbirinin üzerine kurulur:

Kendiniz deneyin

  1. 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.

  2. 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.

  3. 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.

  4. 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 coin ve min_spread, not edin. Bu isteği ders 2'de göndereceksiniz.