cTrader CLI kurulumu¶

Bu makalede cTrader CLI'nin nasıl yükleneceği, kimlik bilgileri dosyasının nasıl oluşturulacağı ve Windows, macOS veya Linux üzerinde terminalden ya da Docker konteynerinden bağlantının nasıl doğrulanacağı açıklanmaktadır.

Ön koşullar ¶

• En az bir işlem hesabına bağlı cTrader ID.
• Desteklenen bir paket yöneticisi: Windows için WinGet, macOS ve Linux için Homebrew.
• cBot'lar için .NET 8. Eski cBot'ları cTrader CLI ile çalıştırmadan önce cTrader masaüstü uygulamasının en son sürümünde yeniden derleyin.
• Becerileri kullanabilmek için Node.js 22.20.0 veya üzeri gereklidir.

Paket yöneticisiyle yükleme ¶

Önerilen yöntem, paket yöneticisi aracılığıyla yüklemedir. Paket yöneticisi işletim sisteminiz için doğru sürümü indirir ve ctrader-cli komutunu PATH değişkeninize ekler. Böylece komutu herhangi bir klasörden çalıştırabilirsiniz.

winget install Spotware.cTrader.CLI

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

Docker imajıyla yükleme ¶

cTrader CLI, cBot'ları Linux VPS, yüksek performanslı sunucu veya bulut platformunda barındırmak için uygun bir Linux Docker imajı olarak sunulur. Bu imaj, WSL ile Docker Desktop üzerinden Windows'ta da çalışır.

docker pull ghcr.io/spotware/ctrader-console:latest

cBot çalıştırma kılavuzunda ana makinedeki klasörleri bağlama ve yapılandırmayı ortam değişkenleri üzerinden aktarma işlemleri açıklanır.

Windows üzerinde elle yükleme ¶

Windows'ta paket yöneticisi kullanmak istemiyorsanız ctrader-cli yürütülebilir dosyası cTrader masaüstü uygulamasında zaten bulunur. Dosya genellikle şu konumdadır:

C:\Users\{username}\AppData\Local\Spotware\cTrader\{installationId}

cTrader CLI'yi herhangi bir klasörden çalıştırabilmek için bu dizini PATH değişkeninize ekleyin:

1. ctrader-cli dosyasını içeren klasörün yolunu kopyalayın.
2. Windows Başlat menüsünde Ortam değişkenleri ifadesini arayın ve Sistem ortam değişkenlerini düzenle seçeneğini belirleyin.
3. Sistem Özellikleri penceresinde Ortam Değişkenleri seçeneğini belirleyin.
4. Kullanıcı değişkenleri bölümünde Path öğesine çift tıklayın.
5. Yeni seçeneğini belirleyin, kopyaladığınız yolu yapıştırın ve değişiklikleri kaydetmek için her iletişim kutusunda Tamam seçeneğine tıklayın.

Yüklemeyi doğrulama ¶

Yükleme tamamlandıktan sonra cTrader CLI'nin kullanılabilir olduğunu doğrulayın. İki komut için de oturum açmanız gerekmez.

ctrader-cli --version
ctrader-cli --help

Terminal komutun bulunamadığını bildirirse güncellenen PATH değişkeninin yüklenmesi için terminali kapatıp yeniden açın ve tekrar deneyin.

Kimlik bilgileri dosyası oluşturma ¶

Çoğu komut bir hesap üzerinde işlem yaptığından üç değer gerektirir: cTrader ID, parola ve hesap numarası.

Güvenlik nedeniyle cTrader ID parolanızı doğrudan bir komuta yazmayın. Parolayı bir dosyaya kaydedin ve --pwd-file seçeneğiyle bu dosyanın yolunu belirtin.

1. Not Defteri gibi düz metin düzenleyicisi açın.
2. cTrader ID parolanızı başında veya sonunda boşluk olmadan tek satıra yazın.
3. Dosyayı .pwd veya .txt uzantısıyla, örneğin password.pwd adıyla kaydedin.
4. Dosyayı komutunuzda belirtin: --pwd-file=C:/test/password.pwd.

Kimlik bilgileri dosyasını hazırladıktan sonra iki kimlik doğrulama yönteminden biriyle komutlara iletin.

Docker çalıştırma örneği ¶

Bir konteynerde ana makine dosya yolları --mount üzerinden bağlanır, yapılandırma değerleri ise -e ile aktarılır. Konteynerde cBot başlatmaya yönelik kısa bir örnek:

docker run -d -it \
  --name ctrader.console.run.mybot \
  --mount type=bind,src=/cAlgo/Robots,dst=/mnt/Robots \
  -e CTID='mycid' \
  -e PWD-FILE='/mnt/Robots/ctrader-cli.pwd' \
  -e ACCOUNT='9102302' \
  -e SYMBOL='EURUSD' \
  -e PERIOD='H1' \
  ghcr.io/spotware/ctrader-console:latest run "/mnt/Robots/My bot.algo" --environment-variables

Her seçeneğin nasıl eşlendiği dahil tüm Docker adımları için cBot'ları çalıştırma ve yönetme kılavuzuna bakın.