cTrader CLI

cTrader CLI cho phép nhà giao dịch quản lý tài khoản và các hoạt động giao dịch thuật toán trực tiếp từ bảng điều khiển hoặc terminal mà không cần khởi chạy hoặc phụ thuộc vào ứng dụng cTrader thông thường. Với cTrader CLI, người dùng chỉ cần nhập lệnh vào terminal dựa trên văn bản để truy cập và chạy thuật toán cTrader.

Phương thức khởi chạy và sử dụng

Qua cTrader Windows

Để chạy cBot trong cTrader CLI, nhấp chuột phải vào phiên bản cục bộ của cBot đó trong cTrader Windows và sau đó chọn Khởi động trong quy trình hoạt động bên ngoài.

cTrader CLI sẽ tự động khởi chạy và bắt đầu chạy phiên bản độc lập với ứng dụng cTrader Windows.

Sau khi bạn khởi động một phiên bản cBot trong một quy trình hoạt động bên ngoài cTrader CLI, bạn có thể đóng cTrader Windows để tiết kiệm tài nguyên CPU và RAM, vì cTrader CLI không yêu cầu cTrader Windows phải mở.

Qua dòng lệnh Windows

Bạn có thể khởi chạy cTrader CLI từ bất kỳ chương trình dòng lệnh nào trong Windows, chẳng hạn như Command Prompt hoặc Windows PowerShell.

Đầu tiên, điều hướng đến thư mục chứa ctrader-cli và sao chép đường dẫn. Tệp thực thi cTrader CLI thường nằm trong cùng thư mục với ứng dụng cTrader Windows của bạn:

1

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

Thứ hai, mở Command Prompt hoặc Windows PowerShell, nhập cd, thêm một khoảng trắng và sau đó dán đường dẫn bạn đã sao chép trước đó. Mã của bạn sẽ trông như thế này:

1

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

Chạy mã và chương trình dòng lệnh của bạn sẽ vào thư mục chứa tệp thực thi ctrader-cli.

Cuối cùng, bạn có thể nhập ctrader-cli.exe theo sau là bất kỳ <command> hợp lệ nào và thực thi nó. Ví dụ: bạn có thể chạy ctrader-cli.exe periods để xem các khoảng thời gian có sẵn.

Thêm biến đường dẫn

Đầu tiên, xác định vị trí thư mục chứa ctrader-cli như bạn đã làm trước đó và sao chép đường dẫn.

1

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

Tìm kiếm Biến môi trường trong menu Start của Windows. Nhấp vào Chỉnh sửa biến môi trường hệ thống.

Trong cửa sổ Thuộc tính hệ thống, nhấp vào Biến môi trường. Nhấp đúp vào Path trong phần Biến người dùng cho {tên người dùng}. Trong cửa sổ Chỉnh sửa biến môi trường, nhấp vào nút Mới và sau đó dán đường dẫn bạn đã sao chép trước đó vào trường.

Nhấp vào OK cho đến khi tất cả các hộp thoại được đóng lại.

Thông qua hình ảnh Docker trên Linux

cTrader CLI có sẵn dưới dạng hình ảnh Docker Linux, cho phép bạn chạy cBot trên các phiên bản VPS Linux giá rẻ, máy chủ hiệu suất cao và các nền tảng đám mây đáng tin cậy. Hình ảnh này cũng có thể được sử dụng trên Windows thông qua Docker Desktop (WSL) dưới dạng container Docker.

Hình ảnh Docker cTrader CLI được công bố trong Gói Github của Spotware và các bản phát hành mới được cung cấp với mỗi bản cập nhật lớn của cTrader Windows.

Để sử dụng hình ảnh Docker cTrader CLI, hãy đảm bảo rằng Docker đã được cài đặt trên máy của bạn, sau đó kéo hình ảnh Docker cTrader CLI mới nhất có sẵn:

1

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

Sau khi kéo hình ảnh, bạn cần tạo và chạy một container. Vì các container Docker chạy trong một sandbox ảo hóa được cô lập khỏi hệ điều hành của bạn, bạn phải cho phép container truy cập vào tệp thuật toán cBot và tệp mật khẩu cTID của bạn một cách rõ ràng. Điều này có thể đạt được bằng cách sử dụng tính năng gắn kết của Docker, cho phép container truy cập vào thư mục hoặc tệp từ hệ thống máy chủ.

Lệnh dưới đây tạo một container dựa trên hình ảnh đã kéo và chạy một 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

Các tham số còn lại trong lệnh được giải thích dưới đây:

Bạn cũng có thể tạo một hình ảnh Docker sẵn sàng chạy dựa trên hình ảnh cTrader CLI, sao chép tệp thuật toán của bạn vào đó và sau đó cấu hình trực tiếp tất cả các biến môi trường và cài đặt khác trong hình ảnh.

Các trường hợp sử dụng phổ biến

Đây là danh sách các hoạt động phổ biến mà nhà giao dịch sử dụng cTrader CLI:

• Lấy tất cả ký hiệu

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

  Phản hồi:

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

• Lấy metadata của thuật toán

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

  Phản hồi:

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

• Backtest một 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

• Chạy một cBot với các tham số mặc định

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

• Chạy một cBot với các tham số tùy chỉnh

  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

• Chạy một cBot với các tham số được lưu trong một tệp

  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

Phân tích các lệnh

cTrader CLI hoạt động giống như bất kỳ công cụ dòng lệnh nào. Người dùng nhập ctrader-cli cùng với các lệnh được xác định trước và chạy chúng. Ví dụ, lệnh periods được sử dụng theo cách này để liệt kê tất cả các chu kỳ biểu đồ mà thuật toán có thể chạy:

1

ctrader-cli periods

Một số lệnh có các tùy chọn hoặc đối số tuân theo các quy tắc sau:

• -- được viết trước phiên bản đầy đủ của một tùy chọn (chẳng hạn như --ctid, --symbol) trong khi - được viết trước phiên bản rút gọn (chẳng hạn như -c, -s).

• Giá trị của các tùy chọn có thể được chỉ định bằng cách sử dụng dấu cách (chẳng hạn như --ctid letstrade, --symbol EURUSD) hoặc sử dụng dấu bằng (chẳng hạn như --ctid=letstrade, --symbol=EURUSD).

• Không giống như các tùy chọn, các đối số được nhập nguyên văn. Xem xét đường dẫn đến một thuật toán. Đó là một đối số được nhập đơn giản: C:/test/mycbot.algo

Bất kỳ đường dẫn hoặc giá trị nào chứa dấu cách phải được chỉ định bằng cách sử dụng dấu ngoặc đơn hoặc kép như được minh họa dưới đây:

• Các đối số như 'C:/test for cbot/my cbot.algo' hoặc "C:/test for cbot/my cbot.algo"
• Các tùy chọn như --pwd-file='C:\test for cbot\password.pwd' hoặc --pwd-file="C:\test for cbot\password.pwd" , --start='01/01/2024 12:34' hoặc --start="01/01/2024 12:34" và các tùy chọn khác.

Tạo tệp PWD hoặc TXT

Mật khẩu cho cTrader ID không được chỉ định trực tiếp. Thay vào đó, chúng được lưu trong các tệp PWD hoặc TXT và sau đó tùy chọn --pwd-file được sử dụng để chỉ định đường dẫn đến các tệp (chẳng hạn như --pwd-file=C:\test\password.pwd hoặc --pwd-file=C:\test\password.txt).

Mở một tài liệu trống trong trình soạn thảo văn bản như Notepad, dán hoặc nhập mật khẩu của bạn (không có khoảng trắng), sau đó lưu tệp với phần mở rộng .pwd hoặc .txt.

Tất cả lệnh CLI

Giải thích

Backtest trong cTrader CLI

Backtest cho phép các nhà giao dịch sử dụng dữ liệu lịch sử để đánh giá hiệu suất và độ tin cậy của một cBot, khám phá điểm mạnh hoặc điểm yếu của nó và thử nghiệm với các tham số. Bằng cách mô phỏng giao dịch trên điều kiện thị trường trong quá khứ, backtest giúp xác định cách một thuật toán có thể hoạt động trước khi cam kết tiền thật trong thị trường thực.

Lệnh

Lệnh backtest với tất cả các tùy chọn có thể:

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]

Một ví dụ về lệnh 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 

Báo cáo

Sau khi lệnh backtest được thực thi, cTrader CLI trước tiên hiển thị thông tin về các tham số backtest.

Khi hoạt động backtest kết thúc, cTrader CLI hiển thị tóm tắt kết quả.

Ngoài ra, cTrader CLI lưu kết quả backtest và các chi tiết hữu ích trong một thư mục Backtesting. Mỗi hoạt động backtest có InstanceID và thư mục Backtesting riêng biệt.

Đường dẫn đến một phiên backtest cBot cụ thể: …\data\{cBotName}\{BacktestingInstanceID}\Backtesting

Thư mục data trong đường dẫn trên thường nằm trong cùng thư mục với tệp algo cBot được chỉ định trong quá trình backtest.

Sự kiệnNhật kýTham sốBáo cáo

Tệp JSON sự kiện chứa chi tiết cho mọi sự kiện giao dịch quan trọng.

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

Tệp TXT (văn bản) nhật ký cung cấp thông tin về việc bắt đầu, dừng cBot, các hành động giao dịch và kết quả.

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.

Tệp CBOTSET tham số chứa các tham số và giá trị được sử dụng trong hoạt động backtest.

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

Tệp HTML báo cáo là một báo cáo GUI cung cấp tổng quan về hoạt động backtest, thống kê giao dịch, lịch sử lệnh và nhiều chi tiết quan trọng khác. Nó có thể được xem trong bất kỳ trình duyệt web nào.

Khắc phục sự cố lỗi

API cTrader Algo trong cTrader CLI

Một số thành viên API cTrader Algo hoạt động khác trong cTrader CLI. Bảng dưới đây liệt kê các thành viên và mô tả sự thay đổi trong hành vi của chúng.

Tổng quan

cTrader CLI là một tính năng thiết yếu cho các nhà giao dịch muốn mở rộng phạm vi hoạt động giao dịch thuật toán của họ vì nó cho phép họ chạy và quản lý cBot một cách hiệu quả với các hướng dẫn dòng lệnh đơn giản. Người dùng luôn được khuyến khích tích hợp cTrader CLI với các API hữu ích và dịch vụ của bên thứ ba phù hợp với nhu cầu của họ.