GaiaEx API ile AI İşlem Botu İnşa Etmek

2021'de 23 yaşında bir mühendis, interneti sallayan bir backtest paylaştı: kripto botu, iki yıllık geçmiş veri üzerinde $1.000'ı $4,2 milyona çevirmişti. Sermaye eğrisi mükemmel bir 45 derecelik çizgi halinde yükseliyordu. Yabancılar ondan kodu yalvararak istedi. İşini bıraktı, arkadaşlarından para topladı ve gerçek hesapla işleme başladı.

Her hafta para kaybetti. Dört ay içinde hesap %60 düştü ve botu kapattı.

Botta hiçbir şey „yanlış” değildi. Kod kusursuz çalışıyordu. Sorun, backtest'in geçmişe tam uyacak şekilde defalarca ayarlanmış olmasıydı — ve geçmiş asla birebir tekrar etmez. Strateji herhangi bir genel şey öğrenmek yerine 2019 ve 2020'yi ezberlemişti. Görmediği bir piyasayla karşılaştığı anda ne yapacağını bilemedi.

AI işlem botları hakkındaki en önemli gerçek bu, ve neredeyse hiç kimse bununla başlamıyor: bir botun kalitesi, onun etrafındaki disipline bağlıdır. Gösterişli kısım — model, AI — işin belki %20'si. Diğer %80'i, senin uyurken bir bug'ın veya ani bir çakılmanın hesabını boşaltmasını engelleyen veri hijyeni, yürütme altyapısı ve risk kontrolleri. Bu ders o %80'i öğretiyor.

Pazarlamayı bir kenara koyarsan, işlem botu sadece piyasayı izleyen ve kurallara göre emir veren yazılımdır — insan butona basmadan. „AI”, bu kuralların bir kısmının elle yazılmak yerine veriden öğrenilmesi anlamına gelir, ama iş aynı: bilgiyi otomatik olarak, gece gündüz kararlara dönüştürmek.

İnsanlar bota üç dürüst nedenle yöneliyor:

• Piyasalar hiç kapanmaz. Kripto 24/7/365 işlem görür. Hiçbir insan Pazar sabahı 4'te BTC'yi izleyemez; bot izleyebilir.
• Duygu yok. Bot dip noktasında panikle satış yapmaz veya tepede FOMO ile alım yapmaz. Sen coşkulu veya korkmuş olsan da aynı planı uygular — ki insanların en kötü kararları tam da bu anlarda verilir.
• Hız ve tutarlılık. Bot düzinelerce varlığı değerlendirip milisaniyeler içinde tepki verebilir ve zarar durdur emri koymayı asla „unutmaz”.

Ama şu listede olmayan şeye dikkat et: garanti kâr. Bot, bir stratejiyi çalıştırmanın daha hızlı, yorulmayan, duygusuz bir yoludur. Strateji kötüyse bot sadece daha hızlı ve daha tutarlı bir şekilde para kaybeder. Otomasyon, ne avantajın varsa onu büyütür — ne kusurun varsa onu da.

Makine öğrenmesine dokunmadan önce, gerçek botların büyük çoğunluğunu güçlendiren temel stratejileri anla. Her biri belirli bir tür piyasayı varsayar — ve piyasanın karakteri değiştiğinde sessizce bozulur.

• Izgara botları (grid bots) bir fiyat aralığında bir dizi alım ve satım emri yerleştirir. Fiyat salındıkça bot her kademede alçaktan alır, yükseğe satar. Yatay, dalgalı bir piyasada mükemmel — ama güçlü bir trendde felaket: fiyat ızgaradan çıkar ve elinde zarar eden pozisyonlarla kalırsın (veya hareketi tamamen kaçırırsın).
• DCA (maliyet ortalaması) botları belirli aralıklarla sabit bir miktar alır, çoğu da ortalama giriş fiyatını düşürmek için daha aşağıda „güvenlik emirleri” ekler. Düşüşlerde biriktirmek için harika — ama fiyat düşmeye devam ederse bıçağa yakalanmaya devam edersin ve ortalaman kanamaya devam eder.
• Trend takibi / momentum botları hareketli ortalama kesişimi gibi sinyalleri kullanarak güçlüyü alır, zayıfı satar. Temiz trendlerde büyük kazanırlar ve yatay, kararsız piyasalarda „doğranırlar” — binlerce küçük zararla ölürler.
• Arbitraj botları aynı varlığın farklı platformlarda farklı fiyatlarla işlem görmesinden yararlanır, ucuzdan alıp pahalıya satar. Matematik basit; mühendislik acımasız. Bu, mikrosaniyelerin, ücretlerin ve transfer gecikmelerinin „bedava” kârın gerçek mi yoksa yanılsama mı olduğuna karar verdiği saf bir hız oyunu.
• Piyasa yapıcı botlar hem alış hem satış fiyatı verir ve likidite sağlayarak farkı (spread) kazanır. Sakin piyasalarda kârlı, hızlı piyasalarda tehlikeli — ani bir hareket, senin emri iptal edebileceğinden daha hızlı seni yanlış tarafta doldurabilir.

Bu listede gizli olan ders: her strateji, hangi türde bir piyasada olduğuna dair bir bahistir. Izgara botu „iyi” veya „kötü” değildir — aralıklar için doğru, trendler için yanlıştır. Otomatik işlemde en zor sorun botu inşa etmek değildir; varsayımının artık geçerli olmadığını bilmektir.

İnsanlar „AI işlem botu” derken sanki tek bir betikten bahsediyormuş gibi konuşur. Üretimde ise bu bir hattır (pipeline): girdi alma, özellikler, model, sinyaller, yürütme ve risk — her parça bütün yığını yeniden kablolamadan değiştirilebilir. Bunu bu şekilde inşa etmek akademik bir titizlik değil; sabah 3'te canlı kâr/zarar backtest'ten saptığında ve hangi adımın başarısız olduğunu bilmen gerektiğinde aklını sağlam tutmanın yolu.

Tek bir kararın yolunu takip et:

• Girdi alma (Ingest) borsadan canlı piyasa verisini çeker — fiyatlar, işlemler, emir defteri. GaiaEx emirler ve bakiyeler için REST, defter ve işlemler için WebSocket sunar.
• Özellikler (Features) ham sayıları anlamlı girdilere çevirir: oynaklık, momentum, fonlama oranı, defter dengesizliği.
• Model (kurallar veya ML) bu özellikleri okur ve bir görüş oluşturur.
• Sinyal o görüşü somut bir emre çevirir: yön, boyut, fiyat.
• Yürütme emri borsaya gönderir, yeniden denemeleri ve onayları yönetir.
• Risk her şeyi sarar — ve diğer her aşama üzerinde veto yetkisi vardır.

Disiplin, her aşamayı deterministik ve günlüklenmiş tutmaktır. Her sinyale bir ID, her emre bir client ID, her adıma bir gecikme damgası ekle. Bir şeyler ters gittiğinde — ve gidecek — günlükleri okuyup gerçeğin planla nerede ayrıldığını tam olarak görmek istersin, tahmin etmek değil.

Hype „AI kullan” der. Profesyoneller şunu söyler: sade Türkçeyle okuyabileceğin kurallarla başla. RSI'de eşikler, bir MACD kesişimi, hareketli ortalamasının üstünde hacim. Kurallar günlüklemesi kolay, açıklaması kolay ve bir şey bozulduğunda kimin suçlanacağını bulması kolaydır. Kural tabanlı stratejin para kazanamıyorsa, sinir ağı onu kurtarmaz — sadece senin hata ayıklayamayacağın bir şekilde para kaybeder.

Makine öğrenmesi, örüntüler elle yazılmış kurallar için çok ince veya çok çok boyutlu olduğunda yerini bulur: tablo özellikleri üzerinde gradyan artırmalı ağaçlar, fiyat barları dizisi üzerinde sıra modelleri. İyi kullanıldığında ML, dağınık girdilerden sinyal sıkabilir. Ama sapma (drift) denen vahşi bir başarısızlık modu var: canlı piyasa yavaşça modelin eğitildiği veriye benzemekten çıkar ve performans sessizce çöker. Model kendinden emin tahminler üretmeye devam eder — sadece artık yanlıştırlar ve hiçbir yer hata fırlatmaz.

Bu yüzden olgun masalar bir hibrit çalıştırır: model öneride bulunur, sabit kodlanmış kurallar ve risk limitleri veto eder. AI bir işlem önerebilir; ama asla günlük zarar limitini veya pozisyon üst sınırını geçemez. Makine, iyi sezgileri olan ama şirketi bahse sokma yetkisi olmayan genç bir analisttir.

Bir model, sana verdiğin girdiler kadar akıllıdır. Ham fiyat nadiren yeterlidir — sanat, özellik mühendisliğidir (feature engineering): OHLCV, emir defteri ve türev verisini gerçekten bilgi taşıyan sinyallere çevirmek.

Bir perp masasında, önemli olan özellikler kapanış fiyatının çok ötesine geçer. Fonlama oranı, „kazanan” bir stratejiyi negatife çevirebilecek gerçek, tekrar eden bir maliyet veya gelirdir. Birden çok zaman ufkundaki getiriler zaman dilimleri arası momentumu yakalar. Hacim oranları anormal aktiviteyi işaretler. Emir defteri dengesizliği — alış ve satış derinliği oranı — L2 verisine abone olursan kısa ufuklu bir mikro yapı sinyalidir. Varlıklar arası bağlam (ETH'nin BTC'ye göre nasıl hareket ettiği) piyasa-geneli bir görüş ekler.

Bir disiplin amatörleri profesyonellerden ayırır: karnını doyurmayan özellikleri at. Bir özelliğin permütasyon önemi sıfıra yakınsa, gürültü için gecikme ve aşırı uyum riski ödüyorsun demektir. Daha az, daha güçlü özellikler, her şeyi içine tıkıştıran bir modeli neredeyse her zaman yener.

def engineer_features(df):
    df["log_ret"] = np.log(df["close"] / df["close"].shift(1))
    df["vol_20"] = df["log_ret"].rolling(20).std()
    df["vol_ratio"] = df["volume"] / df["volume"].rolling(20).mean()
    return df.dropna()

Ve özellik çalışmasının en büyük günahına dikkat et: ileri bakış yanlılığı (look-ahead bias). Herhangi bir özellik kaza sonucu, karar anında var olmayacak bilgiyi kullanırsa — gelecekteki bir bar, aynı döneme ait bir kapanış — backtest'in muhteşem görünecek ve canlı hesabın öyle görünmeyecektir. Her özellik, sadece o anda sahip olacağın verilerle hesaplanabilmelidir, istisnasız.

Cazibesiz yürütme katmanı, paranın sessizce sızdığı yerdir. Doğru yaparsan kimse fark etmez; yanlış yaparsan mükemmel bir sinyal gerçek bir zarara dönüşür.

• Emir tipi. Fiyatı önemsediğinde limit emri kullan — kabul edeceğin en kötü fiyatı sen belirlersin. Piyasa emirlerini gerçek aciliyete ayır ve bunların ince ya da hızlı piyasalarda vahşi olabilecek spread artı kayma (slippage) ödediğini kabul et.
• İdempotans. Her zaman bir client order ID ekle. Ağlar aksaklık yapar; ID'siz yeniden denenen bir POST pozisyonunu ikiye katlayabilir. ID ile borsa kopyayı tanır ve görmezden gelir. Bu tek alışkanlık, felaket bir bug sınıfının tamamını önler.
• Geri çekilmeli yeniden denemeler. 429'da (hız sınırlı) veya 5xx'te (sunucu hatası), bekle ve üstel geri çekilme (exponential backoff) ile yeniden dene — API'yi çekiçleyip seni yasaklatma.
• Saat disiplini. İmzalı istekler genellikle HTTP yöntemini, yolu, gövdeyi ve milisaniye zaman damgasını bir HMAC imzasında birleştirir. Borsalar sapmış saatleri olan istekleri reddeder, o yüzden imzalayan makinede NTP çalıştır. Kayan bir saat her emrinin reddedilmesine yol açar ve nedenini bilemezsin.

Bunların hiçbiri „AI” değil. Ama hepsi AI'ının bir dolar kazanıp kazanmayacağına karar verir. Backtest ile canlı hesap arasındaki boşluk büyük ölçüde bu katmandır — ücretler, kayma, gecikme ve uç durumlar — ve bu tam olarak sonraki iki bölümün var olma nedenidir.

Dayanan işlemcileri patlayan işlemcilerden ayıran işlem sırası budur: risk, her emirde bir kapı, işlem sonrası bir özür değildir. Motoru ayarlamadan önce frenleri tasarlarsın.

Pazarlığa açık olmayan kontroller:

• Pozisyon üst sınırları. Tek varlık maruziyetini sınırla — genellikle sermayenin %2–5'i — böylece hiçbir işlem seni yıkamaz.
• Stoplar. ATR'ye (oynaklığa duyarlı) veya sabit tick'lere göre ayarla ve gerçek emirler olarak yerleştir, kafanda niyet olarak değil.
• Günlük zarar durdurma. Hesap günde, mesela, %3 düşerse bot işlem yapmayı durdurur. Tam durma. Bu tek kural, herhangi bir zeki sinyalden daha çok hesap kurtarmıştır, çünkü bir bug'ın veya kötü bir günün yapabileceği zararı sınırlar.
• Acil durdurma anahtarı (kill switch). Tüm açık emirleri iptal eden ve her pozisyonu düzleştiren tek bir eylem. Ayda bir test et. İhtiyacın olan gün, bozuk olduğunu keşfetmek için en kötü gündür.

Perp'ler için, fonlama sürtünmesini ve tasfiye uzaklığını aynı kapıya dahil et — fiyatta „iyi” görünen bir pozisyon fonlama tarafından kan kaybediyor veya tasfiyeye bir kılıç uzaklığında olabilir.

Saklama da bu sohbete dahil. GaiaEx, anahtar materyalini taraflar arasında bölen MPC kullanır, böylece bot bir saldırganın kapabileceği bir dosyada ham özel anahtar tutmaz asla. Ve işlem yetkileri para çekme yetkilerinden ayrı şekilde sınırlandırılabilir — o yüzden botunun emir vermek için kullandığı bir API anahtarına asla fonları platformdan çıkarma izni verilmemelidir.

Parlak bot reklamlarının hiç bahsetmediği bir risk var: perakendeye pazarlanan „AI işlem botlarının” büyük bir kısmı işlem aracı falan değil — soygunun kendisidir. Dürüst eğitim bunu açıkça söylemeli, çünkü „botlar” yüzünden para kaybeden çoğu insan aslında parasını burada kaybediyor.

Örüntüler tekrar ediyor:

• Garanti getiri veren botlar. „AI'mız günde risk almadan %2 kazandırıyor.” Hiçbir gerçek strateji getiriyi garanti etmez; piyasalar tanım olarak belirsizdir. Kararlı, kaybetmeyen kâr vaadi, bir Ponzi vaadidir.
• Aşırı yetkili API anahtarları. Çoğu dolandırıcı bot senden para çekme yetkisi olan bir API anahtarı bağlamanı ister. Bunu yaptığın anda hesabı boşaltabilirler. 2025 sonlarında, Binance yetkisiz üçüncü taraf botlardan kaynaklanan, tam olarak bunu yapan, hacklenmiş hesap ve beş haneli zarar vakalarını belgeledi.
• Opak, denetlenmemiş kod. Kapalı kaynaklı, güvenlik denetiminden geçmemiş üçüncü taraf botlar arka kapı barındırabilir. Kodun anahtarlarınla ne yaptığını çok geç olana kadar göremezsin.
• Yıkama işlemi (wash-trading) ve hacim çiftçiliği yapan botlar sessizce borsa kurallarını çiğner — hesabını kısıtlanmaya veya askıya alınmaya götürür, zararlar için hiçbir destek olmaz.

Savunmalar somut ve akılda tutmaya değer. Hiçbir işlem botuna asla para çekme yetkisi verme — API anahtarlarını sadece işleme sınırla. Fonların sadece önceden onayladığın adreslere gidebilmesi için para çekme adresi beyaz listesini kullan. Güçlü 2FA'yı (kimlik doğrulayıcı uygulama veya donanım güvenlik anahtarı, SMS değil) etkinleştir. Anonim Telegram botlarının ay vaat etmesi yerine resmi, denetlenmiş araçları tercih et. Ve finansın en eski kuralını unutma: bir şey gerçek olamayacak kadar iyi görünüyorsa, o dolandırıcılıktır ve „AI” sadece kostümüdür.

Bir stratejin, temiz özelliklerin, bir yürütme katmanın ve risk kapıların var. Cazibe, gerçek boyutla direkt canlıya almaktır. Yapma. Ölü botların mezarlığı, kağıt üzerinde mükemmel görünen ama gerçekle hazırlıksız karşılaşan stratejilerle dolu.

Disiplinli yol:

• Tam olarak aynı kod yolu ile simülasyon işlemi yap. Canlı emir mantığını canlı veriye karşı, anaparayı riske atmadan en az birkaç hafta çalıştır. Gerçekleşmeleri ve zaman damgalarını stratejinin beklediğiyle karşılaştır. Simülasyon ve backtest zaten uyuşmuyorsa, dur ve nedenini bul.
• Minimum boyutla canlıya geç. İlk canlı fazın amacı kâr değil — gerçeği ölçmektir: gerçek kayma, gerçek ücretler, gerçek gecikme. Çoğu takım rakamlara güvenmeden önce backtest'e kıyasla %30–50'lik bir kesinti varsayar.
• Canlı, modellenenle eşleştiğinde ölçeklendir. Gerçek kayma ve ücretler varsayımlarınla örtüştüğünde, boyutu kademeli olarak artır. Örtüşmüyorsa, modelin sana yalan söylüyor — parayı yatırmadan önce düzelt.

Ve kötü gün gelmeden önce planla. Ani çakılmalar ve API kesintileri varsayımsal değil — sadece tarihini bilmediğin planlanmış olaylardır. Tek acil planın „sabah fark ederim” ise, acil planın yok demektir. Borsanın desteklediği yerde bağlantı kesilince düzleştirmeyi (flatten-on-disconnect) otomatikleştir, böylece düşen bir bağlantı sen uyurken çıplak bir pozisyonun çalışmasına neden olamaz.