cTrader CLI

cTrader CLI memungkinkan trader untuk mengelola operasi akun dan algo-trading langsung dari konsol atau terminal tanpa meluncurkan atau bergantung pada aplikasi cTrader biasa. Dengan cTrader CLI, pengguna cukup mengetikkan perintah ke terminal berbasis teks untuk mengakses dan menjalankan algoritma cTrader.

Metode peluncuran dan penggunaan

Melalui cTrader Windows

Untuk menjalankan cBot di cTrader CLI, klik kanan instansi lokal cBot tersebut di cTrader Windows dan kemudian pilih Mulai dalam proses eksternal.

cTrader CLI diluncurkan secara otomatis dan mulai menjalankan instansi secara independen dari aplikasi cTrader Windows.

Setelah Anda memulai instansi cBot dalam proses eksternal cTrader CLI, Anda dapat menutup cTrader Windows untuk menghemat sumber daya CPU dan RAM, karena cTrader CLI tidak memerlukan cTrader Windows tetap terbuka.

Melalui baris perintah Windows

Anda dapat meluncurkan cTrader CLI dari program baris perintah apa pun di Windows, seperti Command Prompt atau Windows PowerShell.

Pertama, navigasikan ke folder yang berisi ctrader-cli dan salin jalurnya. File eksekusi cTrader CLI biasanya terletak di direktori yang sama dengan aplikasi cTrader Windows Anda:

1

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

Kedua, buka Command Prompt atau Windows PowerShell, ketik cd, tambahkan spasi dan kemudian tempel jalur yang Anda salin sebelumnya. Kode Anda harus terlihat seperti ini:

1

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

Jalankan kode tersebut, dan program baris perintah Anda akan memasuki direktori yang berisi file eksekusi ctrader-cli.

Terakhir, Anda dapat mengetikkan ctrader-cli.exe diikuti oleh <command> yang valid dan mengeksekusinya. Misalnya, Anda dapat menjalankan ctrader-cli.exe periods untuk melihat periode yang tersedia.

Tambahkan variabel jalur

Pertama, temukan folder yang berisi ctrader-cli seperti yang Anda lakukan sebelumnya dan salin jalurnya.

1

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

Cari Environment variables di menu Start Windows. Klik Edit the system environment variables.

Di jendela System properties, klik Environment variables. Klik dua kali Path di bawah User variables for {username}. Di jendela Edit environment variable, klik tombol New lalu tempel jalur yang Anda salin sebelumnya ke dalam bidang tersebut.

Klik OK sampai semua dialog ditutup.

Melalui gambar Docker Linux

cTrader CLI tersedia sebagai Linux Docker image, memungkinkan Anda untuk menjalankan cBot pada instance VPS Linux yang murah, server berkinerja tinggi, dan platform cloud yang andal. Image ini juga dapat digunakan di Windows melalui Docker Desktop (WSL) sebagai kontainer Docker.

Image Docker cTrader CLI dipublikasikan di bawah Spotware Github packages dan rilis baru disediakan dengan setiap pembaruan utama cTrader Windows.

Untuk menggunakan image Docker cTrader CLI, pastikan Docker terinstal di mesin Anda, lalu tarik image Docker cTrader CLI terbaru yang tersedia:

1

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

Setelah menarik image, Anda perlu membuat dan menjalankan kontainer. Karena kontainer Docker berjalan dalam sandbox virtual yang terisolasi dari sistem operasi Anda, Anda harus secara eksplisit mengizinkan kontainer untuk mengakses berkas algoritma cBot dan berkas kata sandi cTID Anda. Ini dapat dicapai menggunakan fitur mount Docker, yang memungkinkan kontainer mengakses direktori atau berkas dari sistem host.

Perintah di bawah ini membuat kontainer berdasarkan image yang ditarik dan menjalankan cBot:

1

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

1
2
3
4
5
6
7
8
9

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

Parameter lainnya dalam perintah dijelaskan di bawah ini:

Anda juga dapat membuat image Docker siap-pakai berdasarkan image cTrader CLI, menyalin berkas algoritma Anda ke dalamnya, dan kemudian mengonfigurasi semua variabel lingkungan dan pengaturan lainnya langsung di dalam image.

Kasus penggunaan umum

Ini adalah daftar operasi populer yang digunakan trader untuk cTrader CLI:

• Dapatkan semua simbol

  1	ctrader-cli symbols --ctid=letstrade@email.com --pwd-file=C:/test/password.pwd --account=1234567

  Respons:

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

  [ { "Id": 1, "Name": "EURUSD", "Description": "Euro vs US Dollar" }, . . . { "Id": 21497, "Name": "HONG KONG 50", "Description": "HONG KONG 50" } ]

• Dapatkan metadata algo

  1	ctrader-cli metadata C:/test/RSI_cBot.algo

  Respons:

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

  { "Name": "RSI_cBot", "Type": "cBot", "AccessRights": "None", "BuildTime": "2023-05-11T16:42:56.7421508+03:00", "Parameters": [ { "PropertyName": "Quantity", "FriendlyName": "Quantity (Lots)", "GroupName": "Volume", "Type": "Double", "DefaultValue": 1.0, "MinValue": 0.01 }, { "PropertyName": "Source", "FriendlyName": "Source", "GroupName": "RSI", "Type": "DataSeries", "DefaultValue": { "OwnerId": "00000000-0000-0000-0000-000000000000", "FriendlyName": "Close", "IsStandard": true } }, { "PropertyName": "Periods", "FriendlyName": "Periods", "GroupName": "RSI", "Type": "Integer", "DefaultValue": 14 } ] }

• Lakukan backtesting cBot

  1	ctrader-cli run C:\test\mycbot.algo -c=letstrade@email.com --pwd-file=C:\test\password.pwd --account=1234567 --symbol=EURUSD --period=h1

• Jalankan cBot dengan parameter default

  1	ctrader-cli run C:\test\mycbot.algo -c=letstrade --pwd-file=C:\test\password.pwd --account=1234567 --symbol=EURUSD --period=h1

• Jalankan cBot dengan parameter kustom

  1	ctrader-cli run C:\mycbot.algo -c=letstrade@email.com --pwd-file=C:\test\password.pwd --account=1234567 --symbol=EURUSD --period=h1 --ConsolidationPeriods=3 --Periods=15

• Jalankan cBot dengan parameter yang disimpan dalam berkas

  1	ctrader-cli run C:\mycbot.algo C:\test\mysettings.cbotset -c=letstrade --pwd-file=C:\test\password.pwd --account=1234567 --symbol=EURUSD --period=h1

Penjelasan perintah

cTrader CLI beroperasi dengan cara yang sama seperti alat baris perintah lainnya. Pengguna mengetikkan ctrader-cli bersama dengan perintah yang telah ditentukan dan menjalankannya. Misalnya, perintah periods digunakan seperti ini untuk menampilkan daftar semua periode grafik di mana algoritma dapat dijalankan:

1

ctrader-cli periods

Beberapa perintah memiliki opsi atau argumen yang mengikuti aturan-aturan ini:

• -- ditulis sebelum versi lengkap dari sebuah opsi (seperti, --ctid, --symbol) sementara - ditulis sebelum versi singkat (seperti, -c, -s).

• Nilai opsi dapat ditentukan menggunakan spasi (seperti, --ctid letstrade, --symbol EURUSD) atau menggunakan tanda sama dengan (seperti, --ctid=letstrade, --symbol=EURUSD).

• Tidak seperti opsi, argumen diketik apa adanya. Pertimbangkan jalur ke sebuah algoritma. Ini adalah argumen yang cukup diketik: C:/test/mycbot.algo

Setiap jalur atau nilai yang mengandung spasi harus ditentukan menggunakan tanda kutip tunggal atau ganda seperti yang ditunjukkan di bawah ini:

• Argumen seperti 'C:/test for cbot/my cbot.algo' atau "C:/test for cbot/my cbot.algo"
• Opsi seperti --pwd-file='C:\test for cbot\password.pwd' atau --pwd-file="C:\test for cbot\password.pwd" , --start='01/01/2024 12:34' atau --start="01/01/2024 12:34" dan lainnya.

Membuat berkas PWD atau TXT

Kata sandi untuk cTrader ID tidak ditentukan secara langsung. Sebaliknya, kata sandi disimpan dalam berkas PWD atau TXT dan kemudian opsi --pwd-file digunakan untuk menentukan jalur ke berkas tersebut (seperti, --pwd-file=C:\test\password.pwdatau --pwd-file=C:\test\password.txt).

Buka dokumen kosong di editor teks seperti Notepad, tempel atau ketik kata sandi Anda (tanpa spasi), lalu simpan berkas dengan ekstensi .pwd atau .txt.

Semua perintah CLI

Penjelasan

Backtesting di cTrader CLI

Backtesting memungkinkan trader untuk menggunakan data historis untuk menilai kinerja dan keandalan cBot, menemukan kekuatan atau kelemahannya, dan bereksperimen dengan parameter. Dengan mensimulasikan trading pada kondisi pasar masa lalu, backtesting membantu menentukan bagaimana kinerja algoritma sebelum dana riil digunakan dalam pasar live.

Perintah

Perintah backtest dengan semua opsi yang mungkin:

1

ctrader-cli backtest <cbot.algo> [<params.cbotset>] --start=<start-time> --end=<end-time> --data-mode=<data-mode> [--data-file=<path>] [--balance=<balance>] [--commission=<commission>] [--spread=<pips>] [--report=<path>] --ctid=<ctid> --pwd-file=<path> --account=<id> --symbol=<name> --period=<period> [--CustomParameter1=<value>] [--environment-variables]

Contoh perintah backtest:

1

ctrader-cli backtest 'C:\test\sample martingale.algo' C:\test\special-parameters.cbotset --start='01/01/2024 12:34' --end='31/08/2024 20:56' --balance=10000 --commission=30 --data-mode=m1 --spread=1 --ctid=letstrade --pwd-file=C:\test\password.pwd --account=4791386 

Laporan

Setelah perintah backtest dijalankan, cTrader CLI pertama-tama menampilkan informasi tentang parameter backtesting.

Ketika operasi backtesting selesai, cTrader CLI menampilkan ringkasan hasil.

Selain itu, cTrader CLI menyimpan hasil backtesting dan detail yang berguna dalam folder Backtesting. Setiap operasi backtesting mendapatkan InstanceID dan folder Backtesting uniknya sendiri.

Path ke instance backtesting cBot tertentu: …\data\{cBotName}\{BacktestingInstanceID}\Backtesting

Folder data dalam path di atas biasanya berada di direktori yang sama dengan file algo cBot yang ditentukan selama backtesting.

PeristiwaLogParameterLaporan

File JSON events berisi detail untuk setiap peristiwa trading penting.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77

[ { "serial": 0, "orderId": null, "positionId": 1, "event": "Create Position", "time": 1704146700000, "volume": 100000, "quantity": 1, "type": "Sell", "entryPrice": 1.10426, "tp": 1.10026, "sl": 1.10826, "closePrice": null, "grossProfit": 0, "pips": 0, "balance": null, "equity": 10000 }, . . . { "serial": 284, "orderId": null, "positionId": 143, "event": "Create Position", "time": 1725023280000, "volume": 200000, "quantity": 2, "type": "Buy", "entryPrice": 1.10559, "tp": 1.10959, "sl": 1.10159, "closePrice": null, "grossProfit": 0, "pips": 0, "balance": null, "equity": 32340.43 } ]

File TXT (teks) log memberikan informasi tentang mulai, berhenti, tindakan trading, dan hasil cBot.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

Info | CBot instance [sample martingale, EURUSD, h1] started. 01/01/2024 22:05:00.000 | Trade | Executing Market Order to Sell 100000 EURUSD (SL: 40, TP: 40) 01/01/2024 22:05:00.000 | Trade | → Executing Market Order to Sell 100000 EURUSD (SL: 40, TP: 40) SUCCEEDED, Position PID1 02/01/2024 10:12:00.000 | Info | Closed 02/01/2024 10:12:00.000 | Trade | Executing Market Order to Buy 100000 EURUSD (SL: 40, TP: 40) 02/01/2024 10:12:00.000 | Trade | → Executing Market Order to Buy 100000 EURUSD (SL: 40, TP: 40) SUCCEEDED, Position PID2 02/01/2024 12:22:00.000 | Info | Closed 02/01/2024 12:22:00.000 | Trade | Executing Market Order to Buy 200000 EURUSD (SL: 40, TP: 40) 02/01/2024 12:22:00.000 | Trade | → Executing Market Order to Buy 200000 EURUSD (SL: 40, TP: 40) SUCCEEDED, Position PID3 . . . 30/08/2024 13:08:00.000 | Info | Closed 30/08/2024 13:08:00.000 | Trade | Executing Market Order to Buy 200000 EURUSD (SL: 40, TP: 40) 30/08/2024 13:08:00.000 | Trade | → Executing Market Order to Buy 200000 EURUSD (SL: 40, TP: 40) SUCCEEDED, Position PID143 Info | CBot instance [sample martingale, EURUSD, h1] stopped.

File CBOTSET parameter berisi parameter dan nilai yang digunakan dalam operasi backtesting.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

{ "Chart": { "Symbol": "EURUSD", "Period": "h1" }, "Parameters": { "InitialQuantity": "1", "StopLoss": "40", "TakeProfit": "40" } }

File HTML laporan adalah laporan GUI yang memberikan gambaran umum tentang operasi backtesting, statistik trading, riwayat order, dan banyak detail penting. Ini dapat dilihat di browser web mana pun.

Pemecahan masalah error

API cTrader Algo di cTrader CLI

Beberapa anggota API cTrader Algo berperilaku berbeda di cTrader CLI. Tabel di bawah ini mencantumkan anggota-anggota tersebut dan menjelaskan perubahan dalam perilaku mereka.

Ringkasan

cTrader CLI adalah fitur penting bagi trader yang ingin memperluas cakupan aktivitas algo-trading mereka karena memungkinkan mereka untuk menjalankan dan mengelola cBot secara efisien dengan instruksi command-line yang mudah. Pengguna selalu didorong untuk mengintegrasikan cTrader CLI dengan API yang berguna dan layanan pihak ketiga yang sesuai dengan kebutuhan mereka.