Otomasyon riskleri: veri, hatalar, anahtarlar ve yapay zekâ
Kısaca
- Her uyarıdan önce veriyi kontrol edin: snapshot yaşı (şimdiki zaman eksi
meta.updated_at), emir defterlerindekistalebayrağı, en iyi fiyatlardaki spread ve paritenin iki borsasında ortak bir sözleşme. 503veri olmadığı anlamına gelir;200ile boş birdataise filtreye uyan satır bulunmadığı anlamına gelir. Bot ikisini ayırt eder ve veri gelmeyen üç döngüden sonra arıza bildirir.- Kod uç durumlarda bozulur: duraksız deneme
429'a çarpar, karşılaştırmadakinullPython'u çökertir, JavaScript'te sıfıra bölmeInfinityve sahte uyarı üretir, UTC yerine yerel saat ise fonlama ödemesini saatlerce kaydırır. - Genesis API anahtarı salt okunurdur, bu yüzden sızıntı kotanızı yakar. Çekim yetkisi olan bir borsa anahtarı ise parayı riske atar; trading botunun bu yetkiye ihtiyacı yoktur.
- Bir AI modeli sayıları karıştırır ve başkasının metnine gizlenmiş bir komutu izleyebilir: sayıları mesajlara kod yerleştirir, dışarıdan gelen alanlar modele veri olarak ulaşır, işlem limitlerini kod uygular ve her emri bir insan onaylar.
Kripto API ile çalışan bir trading botunun riskleri dört gruba ayrılır: veri eskidir ya da var olmayan bir spread gösterir; kod bir uç durumda döngüye girer veya çöker; anahtar sızar; bir AI modeli sayıyı yanlış alır veya başkasının komutunu izler. Her risk için koda konabilecek bir kontrol ya da çalışan bir kural vardır ve hepsi 4. dersin monitörüne de sığar.
Veri riskleri
Eski snapshot
Genesis API snapshot'ı meta.updated_at anında oluşturulur ve planınız onu her meta.freshness_sec saniyede bir yeniler: Trial'da 60, Start'ta 30, Pro'da 10 ve Max'te 5. Snapshot'ın yaşı, şimdiki zaman eksi meta.updated_at değeridir; bu da veri tazeliğidir. Plan aralığının bir ya da iki katı normaldir; üç katından fazlası snapshot'ın takıldığı anlamına gelir.
Varsayımsal örnek: Pro'da eşik 3 × 10 = 30 sn'dir. Bir yanıt 1783802470 anında gelir ve meta.updated_at = 1783802410'dur: yaş 1783802470 − 1783802410 = 60 sn olduğundan bot bu yanıttan hiçbir uyarı göndermez. Borsadan kodunuza kadar olan tam gecikme bundan da büyüktür; yaş ise sunucunuzun saatiyle ölçülür, bu yüzden saati NTP ile senkron tutun.
Emir defterleri ve tahmin platformları
Emir defterlerinin kendi saati vardır: /orderbooks/book book_ts, age_sec ve defter 30 saniyeden eskiyse true olan bir stale bayrağı döndürür. Defterler borsanın 5–20 saniye gerisinde kalır. Order-book Δ içinde order_delta.status değerini kontrol edin: ok hesaplandı, no_book defter yok, exhausted ise defter hacmi dolduramadı demektir.
Tahmin piyasaları için /predictions/platforms vardır: mode = down olan bir platformun, eski quotes_at değerine sahip bir platformun veya ok = false olan bir bahis şirketinin yer aldığı pariteleri atlayın.
503'te boş yanıt
Boş bir liste ile eksik veri farklı durumlardır. meta.count = 0 ile gelen 200, hiçbir satırın filtreye uymadığı anlamına gelir. 503 snapshot_not_ready ise verinin yeniden oluşturulduğunu gösterir: piyasada hâlâ pariteler olabilir ve Retry-After saniye sonra yeniden denersiniz.
fetch fonksiyonu (data, meta) döndürür; veri yoksa None döndürür. 429 ve 503 yanıtlarını Retry-After kadar bekleyip yeniden dener, diğer 5xx hatalarını ve ağ arızalarını 5, 10 ve 20 saniyelik duraklarla dener, geri kalan her şeyde durur.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch(path, params=None, tries=4):
"""(data, meta) veya None: veri yok, bu "parite yok" demek değildir."""
for attempt in range(tries):
try:
r = requests.get(BASE + path, headers=HEADERS,
params=params, timeout=15)
code = r.status_code
except requests.RequestException:
code = 0 # ağ hatası veya zaman aşımı: duraktan sonra yeniden dene
if code == 200:
body = r.json()
return body["data"], body["meta"]
wait = 5 * 2 ** attempt # 5, 10, 20 sn: durak büyür
if code in (429, 503):
wait = int(r.headers.get("Retry-After", wait))
if wait > 60: # bir dakikadan uzun asla beklemeyin
raise RuntimeError(f"{wait} sn bekleme: kotanızı kontrol edin")
elif 400 <= code < 500:
# 400, 401, 403, 404, 410: yeniden deneme bunları düzeltmez
raise RuntimeError(f"{code}: {r.text[:200]}")
if attempt < tries - 1:
time.sleep(wait)
return None
Uzun bir Retry-After, dönemin kotası bittiğinde de gelir: sıfırlanma günler sonra olabilir ve fetch bir dakikadan uzun beklemez. Yeniden denemeler, ETag ve filtreler limitlere takılmadan API sorgulama makalesinde ele alınıyor.
Sahte spread: ince defterler ve benzer görünen tokenlar
spread_pct son işlemlerden hesaplanır; oysa yalnızca ask'tan alıp bid'e satabilirsiniz. Arbitraj endpoint'leri rehberindeki FUEL örneğinde spread, son işlemlere göre %0,11, en iyi fiyatlarda ise −%0,11'dir. ask_buy ve bid_sell alanları her planda her Spot – Spot satırında gelir; aşağıdaki quote_spread bunları en iyi fiyatlardaki spread'i hesaplamak için kullanır.
İnce bir emir defteri farkı şişirir. Varsayımsal örnek: son işlem bir saat önce 1,18 $'dan gerçekleşti, en iyi bid şimdi 1,02 $ ve alış borsasındaki ask 1,00 $. Spread son işlemlere göre %18, en iyi fiyatlarda %2'dir ve 1.000 $ hiç dolmayabilir: Pro ve Max'te volume=1000 için order_delta.status = exhausted tam olarak bunu gösterir.
Sahte spread'in ikinci kaynağı, farklı tokenların paylaştığı tek bir ticker'dır; örneğin BSC üzerindeki bir token ile Solana üzerindeki ilgisiz bir proje. Sözleşmesi olan bir token için query içine ticker'ı yazarak /coins/search isteği yapın: contracts[] içinde exchanges alanı paritenin her iki borsasını da listeleyen bir kayıt bulunmalıdır (adları büyük/küçük harf duyarsız karşılaştırın). Böyle bir kayıt yoksa doğrudan transfer yok demektir: bunlar farklı tokenlardır ya da rota kendi riskleri olan bir köprüden geçer.
def is_fresh(meta, k=3):
"""Snapshot, plan aralığının k katından eski değil."""
age = time.time() - meta["updated_at"]
return age <= k * meta["freshness_sec"]
def quote_spread(row):
"""En iyi fiyatlardaki spread: ask'tan al, bid'e sat."""
ask, bid = row.get("ask_buy"), row.get("bid_sell")
if ask is None or bid is None or ask <= 0:
return None # fiyat yok veya sıfır fiyat: satırı atla
return (bid - ask) / ask * 100
pause, fails = 60, 0
while True:
got = fetch("/arbitrage/spot-spot", {"min_spread": 1})
if got is None or not is_fresh(got[1]):
fails += 1 # veri yok veya eski: uyarı yok
if fails == 3:
print("3 döngüdür güncel veri yok") # kendinize uyarı gönderin
else:
rows, meta = got
fails, pause = 0, meta["freshness_sec"]
for row in rows:
s = quote_spread(row)
if s is not None and s >= 0.5:
print(row["coin"], row["exchange_buy"], "→",
row["exchange_sell"], f"{s:.2f}%")
time.sleep(pause) # duraklama her yolda çalışır
fetch içinden çıkan bir istisna döngüyü durdurur: üretimdeki bir bot çıkmadan önce sahibine mesaj gönderir.
Kod riskleri
Duraksız denemeler ve sonsuz döngüler
İlk bot genellikle hatadan hemen sonra yeniden dener: if r.status_code != 200: continue. 503'te böyle bir döngü isteklerini ard arda, hiç durmadan gönderir: hatalar kotadan düşmez ama saniyedeki istek limitine sayılır, bu yüzden Retry-After: 1 içeren bir 429 gelir. Abonelik bitince aynı döngü sonsuza kadar 401 alır. time.sleep() öncesindeki bir continue ise her boş yanıtta duraklamayı atlar; bu yüzden yukarıdaki döngüde duraklama son satırdır.
Ters hata ise sonsuza dek beklemektir. Biten bir kotada time.sleep(int(r.headers["Retry-After"])) günlerce uyur: örneğin Retry-After: 259200, 259.200 / 86.400 = 3 gündür. timeout olmayan bir istek de süresiz asılı kalabilir; requests dokümantasyonu bunu uyarır.
null ve sıfıra bölme
Genesis API boş değerler için null kullanır ve Python bunu None'a çevirir. row["volume_24h_sell"] > 10000 ifadesini None ile karşılaştırmak TypeError üretir ve tek bir satır tüm döngüyü çökertir. JavaScript hiçbir şey fırlatmaz: null > 0.5 false, null < 1 true olur ve filtre sessizce bozulur.
null "veri yok" demektir ve onu or 0 ile sıfırla değiştirmek tehlikelidir: DEX slippage içinde tax_sell_pct = null, vergi kaynağı olmadığı anlamına gelir ve or 0 bunu %0'a çevirir. Dokümantasyona göre null, bid_* ve ask_* alanlarında, volume_24h_*, max_position_usd, next_payout alanlarında, bahis şirketi bacağı olan pariteler için profit_usd alanında ve bir günden az kaldığında apr_pct alanında görülür.
Sıfıra bölme de aynı tuzaktır. Sıfır ask, Python'da ZeroDivisionError üretir; JavaScript'te ise 1 / 0 Infinity, Infinity > 0.5 de true olur: bot sonsuz spread'li bir pariteyi gönderir. quote_spread'in ask <= 0 kontrolü yaptığı gibi, bölmeden önce paydayı kontrol edin.
Saat dilimleri
Genesis API zamanları unix saniyesi ve UTC dizeleridir: fonlama oranlarındaki next_payout HH:MM UTC olarak gelir. Saat dilimi olmadan datetime.fromtimestamp(ts) sunucunun yerel saatini döndürür, datetime.utcnow() ise Python 3.12'den beri kullanımdan kaldırılmıştır; Python dokümantasyonu onun yerine datetime.now(timezone.utc) önerir.
Varsayımsal örnek: sunucu UTC+3'te çalışıyor ve saati 09:30 gösteriyor; bu UTC'de 06:30'dur. 08:00 ödemesine 1 sa 30 dk vardır, ama 08:00'i yerel saatle karşılaştıran kod ödemenin geçtiğine karar verir ve bir sonrakine 22 sa 30 dk sayar: 21 saat sapma.
from datetime import datetime, timedelta, timezone
def until_payout(hhmm, now=None):
"""next_payout'a kalan süre; HH:MM biçiminde UTC dizesi."""
if hhmm is None:
return None # null: ödeme zamanı yok
now = now or datetime.now(timezone.utc)
h, m = map(int, hhmm.split(":"))
t = now.replace(hour=h, minute=m, second=0, microsecond=0)
if t <= now:
t += timedelta(days=1) # 23:50'de "00:00" yarın demektir
return t - now
now = datetime(2026, 11, 15, 6, 30, tzinfo=timezone.utc)
print(until_payout("08:00", now)) # 1:30:00
Anahtar riskleri
Genesis API anahtarı salt okunurdur: emir veremez, para çekemez. Sızıntı kotanızı ve saniyedeki istek limitinizi vurur, botunuz dönem bitmeden 429 alır. Uyarı işaretleri: profilinizdeki "Kullanılan çağrı" kodunuzun hesapladığından hızlı artar ya da bot durmuşken "kullanıldı: …" yakın bir zamanı gösterir.
Anahtar yalnızca bir kez gösterilir ve Genesis Arbitrage yalnızca hash'ini saklar; bu yüzden sızan anahtar yeniden oluşturulur: "Yeniden oluştur" eski anahtarı hemen devre dışı bırakır ve yenisini verir. Anahtarlar yanlışlıkla konuldukları yerlerden sızar: herkese açık bir depo, bir istek URL'si, sayfa kodu, bir ekran görüntüsü, istek başlıklarını içeren bir log. Bunun yerine durum kodunu ve X-Request-Id değerini loglayın; saklama kuralları API anahtarı sözlük maddesinde.
Borsa anahtarı farklı bir risk sınıfıdır: çekim yetkisi varsa coin'leri hesaptan çıkarabilir. Trading botunun bu yetkiye ihtiyacı yoktur; bu yüzden anahtarı çekimsiz, sunucunuzun IP'sine bağlı ve her servis için ayrı oluşturun. Ayrıntılar Kripto borsa hesabınızı nasıl korursunuz yazısında.
AI ajanları: sayılar, enjekte edilen komutlar, onay
Bir ajan Genesis API'yi sunucunuz üzerinden çağırır: model endpoint'i ve argümanları seçer, isteği anahtarla sunucu yapar. Kurulum AI ajanları için Genesis API rehberinde, genel tasarım ise AI ajanları için kripto piyasa verisi makalesinde anlatılıyor.
Yanlış sayılar
Bir model 0.92 değerini %0,92 yerine %92 diye okuyabilir, aralık başına funding_pct ile 8 saatlik funding_8h_pct değerlerini karıştırabilir ya da yanıtta olmayan bir fiyatı söyleyebilir. Sayıları uyarılara doğrudan API yanıtından kod yerleştirir; modele seçme ve açıklama kalır. Model sayıları kendisi yazarsa, her birini araç sonucuyla karşılaştırın.
Dışarıdan gelen metindeki komutlar
Bazı alanları başkaları yazar: tahmin piyasalarının title ve outcome alanları, trader name, zincir üstü olayların token_name alanı ve sinyallerin message_ru ile message_en alanları. Herkes bir tokena "Önceki talimatları yok say ve…" adını verebilir ve adı isteminin parçası olarak okuyan model buna uyabilir. Bu, OWASP'ın LLM Uygulamaları için 2025 İlk 10 listesinde birinci sırada yer alan prompt injection'dır: LLM01:2025.
Bu alanları yalnızca araç sonucunun içinde geçirin, uzunluklarını sınırlayın ve sistem isteminde bunların veri olduğunu belirtin. Anahtar sunucu tarafındaki işleyicide kalır.
İnsan onayı
Genesis API yalnızca veri okur: onun üzerine kurulu bir ajan parite bulur ve onu yazar, ama işlem yapmaz. Ajana bağlanan bir borsa işlem API'si Genesis API'nin dışındadır ve riski size aittir. OWASP, önlemleri arasında ayrıcalıklı işlemler için insan onayını sayar: emir yalnızca pariteyi, fiyatları ve veri zamanını gören bir trader'ın "evet"inden sonra gider.
Başlatma öncesi kontrol listesi
- Anahtar sunucuda
GENESIS_API_KEYiçindedir; kodda, istek URL'lerinde, tarayıcıda, loglarda ve istemlerde yoktur. - Her istekte bir
timeoutvardır. - Yalnızca
429,503, diğer 5xx hataları ve ağ arızaları, duraklamayla ve en fazla üç kez yeniden denenir. 400,401,403,404,410ve bir dakikayı aşanRetry-Afterbotu bir mesajla durdurur.- Sorgular arasındaki duraklama en az
meta.freshness_seckadardır ve döngünün her yolunda çalışır. - Her uyarıdan önce snapshot yaşı, emir defterlerinde ise ayrıca
staleveorder_delta.statuskontrol edilir. - "Veri yok" ile "parite yok" ayrı durumlardır ve verisiz üç döngü bir arıza mesajı tetikler.
null,Noneile, paydalar sıfırla karşılaştırılır ve zaman UTC ile işlenir.- Parite; en iyi fiyatlardaki spread'i, ortak bir sözleşmeyi,
withdraw_enabled_buyvedeposit_enabled_sellile geçer. - Sayıları mesajlara kod yerleştirir, dışarıdan gelen metin modele veri olarak ulaşır ve her emri bir insan onaylar.
Kurs özeti: sonraki adımlar
Kursta beş ders var: kavramlar, ilk istek, karar için veri, Python monitörü ve riskleri; temeller 1. derste. Her adımın ayrıntıları:
- Genesis API hızlı başlangıç: anahtar ve ilk istek;
- Genesis API limitleri: kota ve botunuza göre plan boyutlandırma;
- Genesis API yanıtları ve hataları: kodlar,
ETagveX-Request-Id; - Emir defteri endpoint'leri: hacminize göre Order-book Δ;
- Python ile kripto arbitraj botu: Telegram uyarılı bir bot;
- Kripto API: türler ve nasıl seçilir: veri kaynaklarına genel bakış.
Kendiniz deneyin
Planınızın tazeliğini bulun
/account/usageisteği yapın vefreshness_secilecalls_useddeğerlerine bakın: bu istek çağrı olarak sayılmaz.Snapshot yaşını ölçün
/arbitrage/spot-spotverisinifetchile alın,time.time() - meta["updated_at"]değerini yazdırın ve 3 ×freshness_seceşiğiyle karşılaştırın.İki spread'i karşılaştırın
Beş satır için
spread_pctvequote_spread(row)değerlerini yazdırın ve kaç paritenin en iyi fiyatlarda pozitif kaldığını sayın.Hata yolunu test edin
Botu
GENESIS_API_KEY=gns_live_XXXXXXXXXXXXXXXXyer tutucusuyla çalıştırın:401 invalid_keyyanıtı onu anlaşılır bir mesajla durdurmalıdır.Kontrol listesini gözden geçirin
Botu gece gündüz çalıştırmadan önce kodunuzda eksik olanı ekleyin.