Yapılandırma Referansı

Tam Yapılandırma Alanı Açıklaması

ByNinja Trading Bot, trading yürütme, borsa bağlantısı ve Telegram iletişimi arasındaki sorumlulukları ayırmak için birden çok yapılandırma modülü kullanır.

Yapılandırma sistemi, kolay dağıtım, hızlı düzenleme ve öngörülebilir başlangıç davranışı sağlayan kasıtlı olarak hafif ve dosya tabanlıdır.


Telegram Yapılandırması

Telegram yapılandırma modülü, Telegram Bot API iletişimi ve TCP entegrasyonu için gereken tüm parametreleri içerir.

TELEGRAM_BOT_TOKEN

Code
TELEGRAM_BOT_TOKEN = "your_telegram_bot_token"

Telegram Bot API ile kimlik doğrulaması için kullanılan Telegram bot tokenı.

Bu token, Telegram içinde BotFather aracılığıyla oluşturulur ve bot örneğini benzersiz şekilde tanımlar.

Sorumluluklar:

  • API isteklerini doğrular
  • Bildirim göndermeyi sağlar
  • Kullanıcı komutlarını almayı sağlar
  • Telegram bot özelliklerine erişim sağlar

Önemli:

  • Tokenı asla herkese açık şekilde göstermeyin
  • Asla herkese açık depolara işlemeyin
  • Özel bir kimlik bilgisi olarak ele alın

TELEGRAM_CHAT_ID

Code
TELEGRAM_CHAT_ID = "your_private_telegram_chat_id"

Bildirimlerin ve trading uyarılarının iletildiği özel Telegram sohbet ID'si.

Bot, iletişimi yalnızca yetkili sahibiyle kısıtlamak için bu ID'yi kullanır.

Sorumluluklar:

  • Uyarıları ve bildirimleri yönlendirir
  • Yetkisiz erişimi kısıtlar
  • Özel komut yürütmeyi sağlar

Tipik kullanım:

  • Kişisel trading bildirimleri
  • Uzaktan bot yönetimi
  • İşlem yürütme izleme

TCP_SERVER_PORT

Code
TCP_SERVER_PORT = 55110

Telegram sunucusu ile trading botu arasındaki iletişim için kullanılan TCP portunu tanımlar.

Her iki uygulama da aynı port değerini kullanmalıdır.

Sorumluluklar:

  • TCP mesaj taşıma
  • Uzaktan komut yönlendirme
  • Gerçek zamanlı log iletme

Önemli:

  • Port sistemde kullanılabilir olmalıdır
  • Güvenlik duvarı kurallarının ayarlanması gerekebilir
  • Her iki süreç de aynı yapılandırmayı paylaşmalıdır

Binance Yapılandırması

Binance yapılandırma modülü, borsa kimlik doğrulama bilgilerini ve trading iletişim ayarlarını içerir.

BINANCE_API_KEY

Code
BINANCE_API_KEY = "your_binance_api_key"

Binance hesabından oluşturulan genel API anahtarı.

Binance hizmetlerine istekleri doğrulamak için kullanılır.

Sorumluluklar:

  • Piyasa verilerine erişim
  • Emir yerleştirme izinleri
  • Hesap bilgilerine erişim

Güvenlik önerileri:

  • Mümkünse IP kısıtlamalarını etkinleştirin
  • Yalnızca trading izinlerini kullanın
  • Para çekme izinlerini etkinleştirmekten kaçının

BINANCE_API_SECRET

Code
BINANCE_API_SECRET = "your_binance_api_secret"

Binance API anahtarıyla eşleştirilmiş özel API gizli anahtarı.

İstek imzalama ve kimlik doğrulama doğrulaması için kullanılır.

Önemli:

  • Kesinlikle özel kalmalıdır
  • Asla herkese açık şekilde gösterilmemelidir
  • Asla loglar veya ekran görüntüleri aracılığıyla gönderilmemelidir

TCP_SERVER_PORT

Code
TCP_SERVER_PORT = 55110

Trading bot TCP istemcisi tarafından kullanılan TCP iletişim portunu tanımlar.

Bu değer, Telegram sunucu yapılandırmasıyla eşleşmelidir.


Trading Yapılandırması

Trading yapılandırma modülü, sermaye tahsisini, trading çiftlerini, strateji davranışını ve portföy risk yönetimini tanımlar.

INITIAL_CAPITAL

Code
INITIAL_CAPITAL = 1000.0

Trading sistemi için sanal veya izlenen başlangıç sermayesini tanımlar.

Kullanım alanları:

  • Performans hesaplamaları
  • Düşüş hesaplamaları
  • Portföy maruziyet takibi
  • Risk yönetimi istatistikleri

Değer USDT cinsinden ifade edilir.

TRADING_PAIRS

Code
TRADING_PAIRS = [
    "AVAXUSDT",
    "LINKUSDT",
    "DOTUSDT",
    "XRPUSDT",
    "ATOMUSDT"
]

Sistem tarafından izlenen ve işlem gören kriptopara sembollerinin listesi.

Her sembol ayrıca TRADING_PARAMETERS sözlüğünde de bulunmalıdır.

Sorumluluklar:

  • Aktif trading piyasalarını tanımlar
  • Sembol aboneliklerini kontrol eder
  • Sembol bazında strateji yürütmeyi sağlar

Pro İpucu: Bir Kod Editörü Kullanın

Yapılandırma dosyalarını düzenlerken çok daha iyi bir deneyim için Visual Studio Code gibi profesyonel bir kod editörü kullanmanızı öneririz.

Download VS Code ↗

Trading Parametreleri Referansı

Her trading çifti, bağımsız bir strateji yapılandırma profili içerir.

Bu tasarım, her piyasanın özel volatilite, trend ve risk parametrelerini kullanmasına olanak tanır.

lot_size

Code
"lot_size": 0.5

Trading çifti için minimum emir miktarı.

Değer, Binance borsa lot büyüklüğü gereksinimlerine uygun olmalıdır.

Amaç:

  • Geçersiz emir boyutlarını önler
  • Borsa uyumluluğunu sağlar
  • Minimum işlem hassasiyetini kontrol eder

position_size

Code
"position_size": 18.0

Tek bir işlem girişi için USDT cinsinden maksimum sermaye tahsisi.

Amaç:

  • Pozisyon maruziyetini kontrol eder
  • İşlem başına riski sınırlar
  • Aşırı tahsisatı önler

Daha yüksek değerler şunları artırır:

  • Potansiyel kar
  • Potansiyel zarar
  • Portföy maruziyeti

take_profit_percent

Code
"take_profit_percent": 2.81

Giriş fiyatına göre hedef kar yüzdesi.

Piyasa bu seviyeye ulaştığında, bot pozisyonu karla kapatır.

Amaç:

  • Kazançları garanti altına alır
  • Ödül hedefini tanımlar
  • Çıkışları standartlaştırır

Örnek:

  • 100 USDT'den giriş
  • %2.81 kar al
  • Hedef çıkış = 102.81 USDT

stop_loss_percent

Code
"stop_loss_percent": 1.41

Giriş fiyatının altında izin verilen maksimum kayıp yüzdesi.

Piyasa işlem aleyhine hareket ederse, pozisyon otomatik olarak kapatılır.

Amaç:

  • Aşağı yönlü riski sınırlar
  • Trading sermayesini korur
  • Büyük düşüşleri önler

Örnek:

  • 100 USDT'den giriş
  • %1.41 zarar durdur
  • 98.59 USDT'den çıkış

trail_activation_percent

Code
"trail_activation_percent": 1.3

Sürükleyen durdurma sistemini etkinleştirmeden önce gereken kar eşiği.

Aktivasyondan önce:

  • Standart zarar durdurma kullanılır

Aktivasyondan sonra:

  • Dinamik sürükleyen koruma başlar

Amaç:

  • Karlı işlemleri korur
  • Karların devam etmesine izin verir
  • Erken çıkışları azaltır

trail_distance_percent

Code
"trail_distance_percent": 0.8

Mevcut piyasa zirvesi ile sürükleyen durdurma seviyesi arasındaki mesafe.

Amaç:

  • Gerçekleşmemiş karları korur
  • Doğal piyasa hareketine izin verir
  • Dinamik çıkışlar oluşturur

Daha küçük değerler:

  • Daha sıkı koruma
  • Daha hızlı çıkışlar
  • Daha hassas davranış

Daha büyük değerler:

  • Daha fazla esneklik
  • Daha uzun işlem süresi
  • Artırılmış geri çekilme toleransı

trail_tight_distance_percent

Code
"trail_tight_distance_percent": 0.5

Daha güçlü direnç veya dönüş koşullarında kullanılan daha sıkı bir sürükleyen durdurma mesafesi.

Amaç:

  • Agresif kar koruması
  • Direnç yakınında daha hızlı işlem çıkışları
  • Azaltılmış kar geri verme

min_ema200_3m_slope

Code
"min_ema200_3m_slope": -0.008

3 dakikalık EMA200 göstergesinin izin verilen minimum eğimi.

Daha yüksek zaman dilimi trend filtresi olarak kullanılır.

Amaç:

  • Güçlü düşüş trendlerinde işlem yapmaktan kaçınır
  • Zayıf piyasa yapısını filtreler
  • Trend uyumunu iyileştirir

min_ema20_1m_slope

Code
"min_ema20_1m_slope": 0.01

1 dakikalık EMA20 göstergesi için gereken minimum eğim.

Kısa vadeli momentum teyidi için kullanılır.

Amaç:

  • Yukarı yönlü ivmeyi tespit eder
  • Yükseliş momentumunu onaylar
  • Yatay piyasa koşullarını filtreler

min_ema50_1m_slope

Code
"min_ema50_1m_slope": 0.005

1 dakikalık EMA50 göstergesi için gereken minimum eğim.

Ek trend teyidi görevi görür.

Amaç:

  • Orta vadeli yönü onaylar
  • Yanlış sinyalleri azaltır
  • Giriş kalitesini iyileştirir

volume_spike_coeff

Code
"volume_spike_coeff": 1.2

Ortalama hacme göre gereken hacim çarpanı.

Bot, yalnızca mevcut hacim yapılandırılmış eşiği aşarsa işlemlere girer.

Amaç:

  • Güçlü piyasa katılımını tespit eder
  • Düşük likiditeli girişlerden kaçınır
  • Kırılma gücünü onaylar

Örnek:

  • Ortalama hacim = 1000
  • Katsayı = 1.2
  • Gereken hacim = 1200+

max_candle_size

Code
"max_candle_size": 0.8

Girişi engellemeden önce izin verilen maksimum mum boyutu yüzdesi.

Amaç:

  • Aşırı büyük mumlardan sonra giriş yapmaktan kaçınır
  • Aşırı uzatılmış hareketleri kovalamayı önler
  • FOMO girişlerini azaltır

min_ema50_ema200_distance

Code
"min_ema50_ema200_distance": 0.06

EMA50 ve EMA200 arasında gereken minimum yüzde mesafesi.

Amaç:

  • Piyasa trend ayrışmasını onaylar
  • Zayıf trendleri filtreler
  • Trend yapısını doğrular

Daha yüksek mesafe değerleri genellikle daha güçlü trendleri gösterir.

min_ema20_ema50_distance

Code
"min_ema20_ema50_distance": 0.10

EMA20 ve EMA50 göstergeleri arasında gereken minimum mesafe.

Amaç:

  • Kısa vadeli momentum gücünü onaylar
  • Zayıf girişleri filtreler
  • Sinyal kalitesini iyileştirir

Risk Parametreleri Referansı

Risk yönetim sistemi, hem bireysel sembolleri hem de tüm portföyü korur.

max_portfolio_exposure

Code
"max_portfolio_exposure": 90.0

Açık pozisyonlara aynı anda tahsis edilebilecek maksimum portföy sermayesi yüzdesi.

Amaç:

  • Aşırı maruziyeti önler
  • Rezerv likiditesini korur
  • Sistemik riski azaltır

max_consecutive_losses

Code
"max_consecutive_losses": 10

Sembol için trading duraklamadan önce izin verilen maksimum ardışık kaybeden işlem sayısı.

Amaç:

  • Kararsız piyasa koşullarını tespit eder
  • Duygusal aşırı trading mantığını önler
  • Strateji bozulma dönemlerini sınırlar

max_daily_drawdown_per_symbol

Code
"max_daily_drawdown_per_symbol": 3.0

Bireysel bir trading çifti için izin verilen maksimum günlük kayıp yüzdesi.

Aşılırsa:

  • Sembol için trading geçici olarak durdurulur

Amaç:

  • Sembole özgü hasarı sınırlar
  • Kararsız piyasalarda tekrarlayan kayıpları önler

max_total_drawdown_per_symbol

Code
"max_total_drawdown_per_symbol": 6.0

Tüm seanslar boyunca bir trading çifti için izin verilen maksimum kümülatif kayıp yüzdesi.

Amaç:

  • Sürekli düşük performans gösteren sembolleri tespit eder
  • Uzun vadeli sermaye erozyonunu önler

max_daily_drawdown

Code
"max_daily_drawdown": 5.0

İzin verilen maksimum günlük portföy kayıp yüzdesi.

Aşılırsa:

  • Tüm trading faaliyeti durur

Amaç:

  • Aşırı piyasa koşullarında portföyü korur
  • Felaket günlük kayıpları sınırlar

max_total_drawdown

Code
"max_total_drawdown": 10.0

Tüm trading yaşam döngüsü boyunca maksimum kümülatif portföy düşüşü.

Amaç:

  • Nihai bir sermaye koruma mekanizması görevi görür
  • Tam strateji başarısızlığını önler
  • Uzun vadeli risk disiplinini uygular

Ulaşıldığında:

  • Manuel inceleme yapılana kadar trading işlemleri devre dışı kalmalıdır.