cTrader CLI

cTrader CLI membolehkan pedagang mengurus operasi akaun dan dagangan algo secara langsung daripada konsol atau terminal tanpa melancarkan atau bergantung pada aplikasi cTrader biasa. Dengan cTrader CLI, pengguna hanya perlu menaip arahan ke dalam terminal berasaskan teks untuk mengakses dan menjalankan algoritma cTrader.

Kaedah pelancaran dan penggunaan

Melalui cTrader Windows

Untuk menjalankan cBot dalam cTrader CLI, klik kanan pada instans tempatan cBot tersebut dalam cTrader Windows dan kemudian pilih Mula dalam proses luaran.

cTrader CLI dilancarkan secara automatik dan mula menjalankan instans secara bebas daripada aplikasi cTrader Windows.

Selepas anda memulakan instans cBot dalam proses luaran cTrader CLI, anda boleh menutup cTrader Windows untuk menjimatkan sumber CPU dan RAM, kerana cTrader CLI tidak memerlukan cTrader Windows untuk terus dibuka.

Melalui baris arahan Windows

Anda boleh melancarkan cTrader CLI daripada mana-mana program baris arahan dalam Windows, seperti Command Prompt atau Windows PowerShell.

Pertama, navigasi ke folder yang mengandungi ctrader-cli dan salin laluan. Fail boleh laku cTrader CLI biasanya terletak dalam direktori yang sama dengan aplikasi cTrader Windows anda:

1

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

Kedua, buka Command Prompt atau Windows PowerShell, taip cd, tambah ruang dan kemudian tampal laluan yang anda salin sebelum ini. Kod anda sepatutnya kelihatan seperti ini:

1

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

Jalankan kod, dan program baris arahan anda akan memasuki direktori yang mengandungi fail boleh laku ctrader-cli.

Akhir sekali, anda boleh menaip ctrader-cli.exe diikuti dengan mana-mana <command> yang sah dan laksanakannya. Contohnya, anda boleh menjalankan ctrader-cli.exe periods untuk melihat tempoh yang tersedia.

Tambah pemboleh ubah laluan

Pertama, cari folder yang mengandungi ctrader-cli seperti yang anda lakukan sebelum ini dan salin laluan.

1

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

Cari Environment variables dalam menu Mula Windows. Klik Edit the system environment variables.

Dalam tetingkap System properties, klik Environment variables. Klik dua kali Path di bawah User variables for {username}. Dalam tetingkap Edit environment variable, klik butang New dan kemudian tampal laluan yang anda salin sebelum ini ke dalam medan.

Klik OK sehingga semua dialog ditutup.

Melalui imej Docker Linux

cTrader CLI tersedia sebagai imej Docker Linux, membolehkan anda menjalankan cBot pada tika VPS Linux yang murah, pelayan berprestasi tinggi dan platform awan yang boleh dipercayai. Imej ini juga boleh digunakan pada Windows melalui Docker Desktop (WSL) sebagai bekas Docker.

Imej Docker cTrader CLI diterbitkan di bawah pakej Github Spotware dan keluaran baharu disediakan dengan setiap kemas kini utama cTrader Windows.

Untuk menggunakan imej Docker cTrader CLI, pastikan Docker dipasang pada mesin anda, kemudian tarik imej Docker cTrader CLI terkini yang tersedia:

1

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

Selepas menarik imej, anda perlu mencipta dan menjalankan bekas. Oleh kerana bekas Docker dijalankan dalam kotak pasir maya yang diasingkan daripada sistem pengendalian anda, anda mesti membenarkan bekas untuk mengakses fail algoritma cBot dan fail kata laluan cTID anda secara jelas. Ini boleh dicapai menggunakan ciri lekapan Docker, yang membolehkan bekas mengakses direktori atau fail daripada sistem hos.

Arahan di bawah mencipta bekas berdasarkan imej 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 yang tinggal dalam arahan dijelaskan di bawah:

Anda juga boleh mencipta imej Docker sedia untuk dijalankan berdasarkan imej cTrader CLI, menyalin fail algoritma anda ke dalamnya dan kemudian mengkonfigurasi semua pemboleh ubah persekitaran dan tetapan lain secara langsung dalam imej.

Kes penggunaan biasa

Ini adalah senarai operasi popular yang digunakan oleh pedagang 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 } ] }

• Jalankan ujian belakang 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 lalai

  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 tersuai

  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 fail

  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

Perincian arahan

cTrader CLI beroperasi dengan cara yang sama seperti mana-mana alat baris arahan. Pengguna menaip ctrader-cli bersama dengan arahan yang telah ditentukan dan menjalankannya. Sebagai contoh, arahan periods digunakan dengan cara ini untuk menyenaraikan semua tempoh carta di mana algoritma boleh dijalankan:

1

ctrader-cli periods

Sesetengah arahan mempunyai pilihan atau hujah yang mengikuti peraturan ini:

• -- ditulis sebelum versi penuh pilihan (seperti, --ctid, --symbol) manakala - ditulis sebelum versi ringkas (seperti, -c, -s).

• Nilai pilihan boleh ditentukan menggunakan ruang (seperti, --ctid letstrade, --symbol EURUSD) atau menggunakan tanda sama dengan (seperti, --ctid=letstrade, --symbol=EURUSD).

• Tidak seperti pilihan, hujah ditaip sebagaimana adanya. Pertimbangkan laluan ke algoritma. Ia adalah hujah yang hanya ditaip: C:/test/mycbot.algo

Sebarang laluan atau nilai yang mengandungi ruang mesti ditentukan menggunakan tanda petik tunggal atau berganda seperti yang ditunjukkan di bawah:

• Hujah seperti 'C:/test for cbot/my cbot.algo' atau "C:/test for cbot/my cbot.algo"
• Pilihan 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 lain-lain.

Mencipta fail PWD atau TXT

Kata laluan untuk ID cTrader tidak ditentukan secara langsung. Sebaliknya, ia disimpan dalam fail PWD atau TXT dan kemudian pilihan --pwd-file digunakan untuk menentukan laluan ke fail (seperti, --pwd-file=C:\test\password.pwdatau --pwd-file=C:\test\password.txt).

Buka dokumen kosong dalam penyunting teks seperti Notepad, tampal atau taip kata laluan anda (tanpa sebarang ruang putih), kemudian simpan fail dengan sambungan .pwd atau .txt.

Semua arahan CLI

Penjelasan

Ujian belakang dalam cTrader CLI

Ujian belakang membolehkan pedagang menggunakan data sejarah untuk menilai prestasi dan kebolehpercayaan cBot, menemui kekuatan atau kelemahan dan bereksperimen dengan parameter. Dengan mensimulasikan dagangan pada keadaan pasaran masa lalu, ujian belakang membantu menentukan bagaimana algoritma mungkin berprestasi sebelum dana sebenar dikomitmen dalam pasaran langsung.

Arahan

Arahan ujian belakang dengan semua pilihan 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 arahan ujian belakang:

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

Selepas arahan backtest dilaksanakan, cTrader CLI mula memaparkan maklumat tentang parameter ujian belakang.

Apabila operasi ujian belakang selesai, cTrader CLI memaparkan ringkasan keputusan.

Selain itu, cTrader CLI menyimpan keputusan ujian belakang dan butiran berguna dalam folder Backtesting. Setiap operasi ujian belakang mendapat InstanceID dan folder Backtesting uniknya sendiri.

Laluan ke contoh ujian belakang cBot tertentu: …\data\{cBotName}\{BacktestingInstanceID}\Backtesting

Folder data dalam laluan di atas biasanya berada dalam direktori yang sama dengan fail algo cBot yang dinyatakan semasa ujian belakang.

PeristiwaLogParameterLaporan

Fail JSON peristiwa mengandungi butiran untuk setiap peristiwa dagangan 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 } ]

Fail log TXT (teks) memberikan maklumat tentang permulaan cBot, berhenti, tindakan dagangan dan hasil.

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.

Fail CBOTSET parameter mengandungi parameter dan nilai yang digunakan dalam operasi ujian belakang.

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" } }

Fail HTML laporan adalah laporan GUI yang memberikan gambaran keseluruhan operasi ujian belakang, statistik dagangan, sejarah pesanan dan banyak butiran penting. Ia boleh dilihat dalam mana-mana pelayar web.

Menyelesaikan masalah ralat

API cTrader Algo dalam CLI cTrader

Sesetengah ahli API cTrader Algo berkelakuan berbeza dalam CLI cTrader. Jadual di bawah menyenaraikan ahli-ahli tersebut dan menerangkan perubahan dalam tingkah laku mereka.

Ringkasan

CLI cTrader ialah ciri penting bagi pedagang yang ingin mengembangkan skop aktiviti dagangan algoritma mereka kerana ia membolehkan mereka menjalankan dan menguruskan cBot dengan cekap menggunakan arahan baris perintah yang mudah. Pengguna sentiasa digalakkan untuk mengintegrasikan CLI cTrader dengan API yang berguna dan perkhidmatan pihak ketiga yang sesuai dengan keperluan mereka.