Menyiapkan cTrader CLI¶

Artikel ini menjelaskan cara menginstal cTrader CLI, membuat file kredensial, dan memverifikasi koneksi di Windows, macOS, atau Linux melalui terminal maupun container Docker.

Prasyarat ¶

• cTrader ID dengan setidaknya satu akun trading.
• Pengelola paket yang didukung: WinGet untuk Windows, serta Homebrew untuk macOS dan Linux.
• Untuk cBot, diperlukan .NET 8. Kompilasi ulang cBot lama menggunakan aplikasi desktop cTrader versi terbaru sebelum menjalankannya dengan cTrader CLI.
• Untuk menggunakan skill, diperlukan Node.js versi 22.20.0 atau yang lebih baru.

Instal dengan pengelola paket ¶

Instalasi melalui pengelola paket adalah metode yang disarankan. Pengelola paket mengunduh build yang sesuai dengan sistem operasi Anda dan menambahkan perintah ctrader-cli ke PATH, sehingga Anda dapat menjalankannya dari folder mana pun.

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

Instal menggunakan image Docker ¶

cTrader CLI tersedia sebagai image Docker Linux, yang memudahkan hosting cBot di VPS Linux, server berkinerja tinggi, atau platform cloud. Image ini juga dapat dijalankan di Windows melalui Docker Desktop dengan WSL.

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

Panduan menjalankan cBot menjelaskan cara memasang folder host dan meneruskan konfigurasi melalui variabel lingkungan.

Instal secara manual di Windows ¶

Jika tidak ingin menggunakan pengelola paket di Windows, Anda dapat memakai file eksekusi ctrader-cli yang sudah disertakan dalam aplikasi desktop cTrader. File ini biasanya berada di:

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

Untuk menjalankan cTrader CLI dari folder mana pun, tambahkan direktori ini ke PATH:

1. Salin jalur folder yang berisi ctrader-cli.
2. Di menu Start Windows, cari Variabel lingkungan, lalu pilih Edit variabel lingkungan sistem.
3. Di jendela Properti Sistem, pilih Variabel Lingkungan.
4. Di bagian Variabel pengguna, klik dua kali Path.
5. Pilih Baru, tempel jalur yang disalin, lalu pilih OK di setiap kotak dialog untuk menyimpan.

Memverifikasi instalasi ¶

Setelah instalasi, pastikan cTrader CLI dapat digunakan. Kedua perintah tersebut tidak mengharuskan Anda login.

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

Jika terminal melaporkan bahwa perintah tidak ditemukan, tutup lalu buka kembali terminal agar PATH yang diperbarui diterapkan, kemudian coba lagi.

Membuat file kredensial ¶

Sebagian besar perintah bekerja pada akun, sehingga memerlukan tiga nilai: cTrader ID, kata sandi, dan nomor akun.

Demi keamanan, jangan masukkan kata sandi cTrader ID secara langsung ke dalam perintah. Simpan kata sandi dalam file dan gunakan --pwd-file untuk menunjukkan file tersebut.

1. Buka editor teks biasa, seperti Notepad.
2. Masukkan kata sandi cTrader ID dalam satu baris, tanpa spasi di awal atau akhir.
3. Simpan file dengan ekstensi .pwd atau .txt, misalnya password.pwd.
4. Rujuk file dalam perintah Anda: --pwd-file=C:/test/password.pwd.

Setelah file kredensial siap, teruskan ke perintah menggunakan salah satu dari dua metode autentikasi.

Contoh menjalankan dengan Docker ¶

Di dalam container, jalur host dipetakan ke container melalui --mount, sedangkan nilai konfigurasi diteruskan melalui -e. Contoh singkat untuk memulai cBot di dalam container:

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

Untuk panduan Docker lengkap, termasuk pemetaan setiap opsi, lihat cara menjalankan dan mengelola cBot.