TARGETHIT!

Diğer

Topluluk

Tema

Dil

Algoritmik işlem okulu/Otomasyon/Kripto borsa API'leri: kodunuzu piyasalara bağlamak
Otomasyon11 dk okuma

Kripto borsa API'leri: kodunuzu piyasalara bağlamak

Kodunuzla borsalar arasındaki arayüzü anlamak

Piyasalara açılan kapı

Borsa API'leri, kodunuzun borsalarla konuşmasını sağlar. İşlem kararlarınızı gerçek pozisyonlara dönüştüren kritik arayüz budur.

REST mi, WebSocket mi?

REST API'leri: İstek-yanıt modeli. Emir vermek, bakiyeleri kontrol etmek ve pozisyonları sorgulamak için kullanılır. Sınırlamaları: istek sınırları (rate limit) ve gerçek zamanlı güncelleme olmaması.

WebSocket API'leri: Borsanın veriyi kendiliğinden size gönderdiği (push) kalıcı bir bağlantı. Fiyat akışları, emir defteri güncellemeleri ve işlem bildirimleri için kullanılır.

Çoğu işlem sistemi ikisini birlikte kullanır: gerçek zamanlı veri için WebSocket, emir işlemleri için REST.

Kimlik doğrulama

Borsalar, işlem yapmaya yönelik çağrılarda kimlik doğrulama ister: API anahtarı (API Key, herkese açık tanımlayıcı) ve API gizli anahtarı (API Secret, imzalamada kullanılan özel anahtar). Çoğu borsa imzalamada HMAC-SHA256 kullanır.

Güvenlik için en iyi uygulamalar:

  • Gizli anahtarları asla git'e commit etmeyin
  • Ortam değişkenleri ya da bir secret manager kullanın
  • Her sistem için ayrı bir API anahtarı oluşturun
  • Mümkün olan her yerde IP beyaz listesini (whitelist) etkinleştirin

İstek sınırları

Her borsa, API'sini ne sıklıkla çağırabileceğinizi sınırlar. Sınırı aşarsanız hata alırsınız ya da geçici olarak engellenirsiniz.

İstek sınırı yönetimini en baştan kurun: kullanımınızı takip edin, sınıra yaklaşırken geri çekilme (backoff) uygulayın, istekleri zamana yaymak için kuyruğa alın ve işlem isteklerine veri isteklerinden önce öncelik verin.

Emir türlerine yakından bakış

Piyasa emri: O anki piyasa fiyatından anında gerçekleşir. Basittir ama gerçekleşme fiyatının garantisi yoktur.

Limit emir: Yalnızca belirlediğiniz fiyattan ya da daha iyisinden gerçekleşir. Hiç gerçekleşmeyebilir de.

Zarar durdur (stop-loss) emri: Stop fiyatına ulaşıldığında bir piyasa emrini tetikler.

Geçerlilik süresi (time-in-force) seçenekleri: GTC (Good Till Cancelled: iptal edildiği ana kadar geçerli), IOC (Immediate or Cancel: hemen gerçekleşmeyen kısım iptal edilir), FOK (Fill or Kill: tamamı hemen gerçekleşmezse emir iptal edilir), GTX (Post Only: emir yalnızca maker olarak deftere girer).

Hata yönetimi

API çağrıları sık sık başarısız olur. Ağ hatalarını (zaman aşımı, bağlantının reddedilmesi) ve borsa hatalarını (geçersiz imza, istek sınırına takılma, yetersiz bakiye) ele alın; hiçbir şeyi varsaymayın, her işlemi doğrulayın.

En tehlikeli durum: emir gönderildi, yanıt gelmedi. Emir gerçekleşti mi, gerçekleşmedi mi? Bunu mutlaka doğrulamalısınız.

Borsalar arasındaki farklar

Her borsa farklıdır. Parametre adları değişir, pozisyon modları farklıdır (tek yönlü ya da hedge), marjin türleri değişir (Cross ya da İzole). CCXT gibi kütüphanelerin var olma nedeni budur: bu farkları normalize ederler.

WebSocket için en iyi uygulamalar

WebSocket bağlantıları kopacaktır. Kodunuz kopmayı anında fark etmeli, geri çekilmeyle (backoff) yeniden bağlanmayı denemeli, kanallara yeniden abone olmalı ve mümkünse kaçırılan veriyi talep etmelidir.

Gerçek para kullanmadan test

İlk testinizi asla gerçek parayla yapmayın. Borsaların testnet ortamlarını (Binance, Bybit ve OKX'in hepsinde bulunur), gerçek veri üzerinde demo işlemi ve emir göndermek yerine yalnızca log yazan deneme modunu (dry run) kullanın.

CCXT: evrensel adaptör

CCXT, 100+ borsaya tek tip bir arayüz sunar; kimlik doğrulamayı, istek imzalamayı, istek sınırı yönetimini ve yanıtların ayrıştırılmasını sizin yerinize halleder. Temel olarak CCXT'yi kullanmanızı, iyi desteklemediği özellikler için ise doğrudan API çağrıları eklemenizi öneriyoruz.

Çıkarım

Borsa API'leri otomatik işlemin temelidir ve üretim ortamındaki hataların çoğunun kaynağıdır. Kimlik doğrulama, istek sınırları, hata yönetimi ve WebSocket bağlantıları konusunda ustalaşın.