Tối ưu hóa cBot¶

Lệnh optimize thử nhiều giá trị tham số của cBot để tìm các tổ hợp đạt kết quả tốt theo những tiêu chí bạn chọn. Lệnh này thực hiện cùng phương pháp tìm kiếm bằng thuật toán di truyền hoặc tìm kiếm theo lưới như ứng dụng cTrader trên máy tính, nhưng được điều khiển từ terminal bằng một tệp JSON chứa các thiết lập tham số. Đây là lệnh tối ưu hóa tương ứng với lệnh backtest.

Phạm vi áp dụng ¶

Lệnh optimize dùng để tối ưu hóa các tham số cBot. Chỉ báo và plugin có các lệnh riêng (indicator calculate, indicator history, create, build) và không thuộc phạm vi tối ưu hóa này.

Điều kiện tiên quyết ¶

• cTrader CLI đã được cài đặt và bạn có thể đăng nhập.
• cBot đã được xuất thành tệp .algo và biên dịch cho .NET 8.
• Có tệp tham số xác định các tham số cần thay đổi trong quá trình tìm kiếm.

Lệnh optimize ¶

ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file> [options]

Đối số đầu tiên là đường dẫn đến tệp .algo. Bắt buộc phải có tùy chọn --params. Khung thời gian cơ sở phải được xác định bằng --timeframe hoặc trong tệp tham số. Nếu cả hai nơi đều không xác định khung thời gian, lệnh sẽ dừng và báo lỗi.

Các tùy chọn tối ưu hóa ¶

Chỉ có --params là bắt buộc. Các tùy chọn không bắt buộc thường dùng trong ví dụ bên dưới gồm --timeframe, --method, --criteria, --optres và --passes-dir.

Bạn nên nắm rõ một số tùy chọn trước khi bắt đầu:

• --method – genetic (mặc định) hoặc grid. Chọn grid nếu có ít tổ hợp tham số và bạn muốn thử tất cả. Nếu có nhiều tổ hợp và cách tìm kiếm có định hướng sẽ nhanh hơn, hãy chọn genetic.
• --cores – số tiến trình xử lý song song thực hiện phần backtest của từng lượt chạy tối ưu hóa. Mỗi tiến trình sử dụng một luồng CPU, vì vậy quá trình tối ưu hóa dùng số luồng xấp xỉ giá trị được chỉ định. Chấp nhận các số nguyên từ 1 trở lên. Giá trị mặc định bằng một nửa số bộ xử lý cộng thêm một. Hãy giảm giá trị trên VPS cấu hình nhỏ để dành tài nguyên cho các tác vụ khác, hoặc tăng giá trị trên máy chuyên dụng để phân bổ tìm kiếm di truyền trên nhiều luồng hơn.
• --auto-select-best – tự động chọn lượt chạy tốt nhất khi tối ưu hóa kết thúc, giúp bạn có ngay tệp .cbotset chứa bộ tham số hiệu quả nhất mà không cần thao tác thêm.

Tệp tham số ¶

Tệp được chỉ định qua --params là một đối tượng JSON chứa mảng parameters. Tệp có cùng cấu trúc với tệp xuất từ giao diện tối ưu hóa của ứng dụng cTrader trên máy tính, nên bạn có thể sử dụng trực tiếp tệp đã xuất từ ứng dụng.

{
  "parameters": [
    { "Name": "SlowPeriods",  "Optimize": true, "Min": "5",  "Max": "50", "Step": "5" },
    { "Name": "StopLossPips", "Optimize": true, "Min": "10", "Max": "60", "Step": "5" },
    { "Name": "MAType",       "Optimize": true, "Values": ["0", "1", "2"] },
    { "Name": "MySymbol",     "Optimize": true, "Values": ["EURUSD", "GBPUSD"] }
  ]
}

Quy tắc đối với các trường ¶

• Trường Name là bắt buộc và phải khớp với tên thuộc tính của cBot. Chạy ctrader-cli metadata <path-to-algo> để xem các tên thuộc tính có sẵn. Nếu tên không có trong siêu dữ liệu của cBot, hệ thống sẽ ghi nhận vào nhật ký và bỏ qua tham số đó. Quá trình tối ưu hóa tiếp tục với các tham số còn lại.
• Khi Optimize có giá trị true, tham số được đưa vào quá trình tìm kiếm. Khi có giá trị false, tham số được giữ cố định.
• Các tham số dạng khoảng giá trị, chẳng hạn số nguyên và số thực độ chính xác kép, cần có Min, Max và Step nếu muốn quét nhiều giá trị.
• Các tham số nhận giá trị rời rạc, như kiểu liệt kê và ký hiệu, cần có mảng Values không rỗng nếu muốn quét nhiều giá trị.
• Trường ParameterType là không bắt buộc. Nếu không có trường này, kiểu dữ liệu sẽ được xác định từ siêu dữ liệu của cBot bằng cách đối chiếu với Name.

Cố định tham số ở một giá trị ¶

Để giữ nguyên giá trị của một tham số, hãy thêm tham số đó với Optimize: false và giá trị Value tương ứng:

{ "Name": "MAType",      "Value": "1", "Optimize": false },
{ "Name": "FastPeriods", "Value": "5", "Optimize": false }

Tối ưu hóa khung thời gian chính ¶

Ngoài các tham số cBot, lệnh optimize còn có thể thử nhiều khung thời gian chính. Khung thời gian chính có thể được lấy từ hai nguồn, trong đó --timeframe được ưu tiên.

• --timeframe <tf> – một giá trị sẽ cố định khung thời gian chính; nhiều giá trị phân tách bằng dấu phẩy sẽ cho phép thử các khung thời gian khác nhau.
• Tệp tham số – tệp xuất từ ứng dụng trên máy tính đã có sẵn một tham số khung thời gian tổng hợp dành riêng cho mục đích này.

Khung thời gian cơ sở của dữ liệu là giá trị duy nhất được chỉ định, giá trị đã cố định hoặc khung thời gian nhỏ nhất trong các giá trị được thử.

Khả năng tương thích giữa khung thời gian và chế độ dữ liệu ¶

Các khung thời gian chính, dù được thử hay cố định, đều phải tương thích với --data-mode đã chọn.

Tiêu chí ¶

Mỗi mục trong --criteria ghép một chỉ số hiệu suất với hướng max hoặc min, chẳng hạn NetProfit:max. Bảng dưới đây liệt kê toàn bộ tên chỉ số được hỗ trợ và ý nghĩa của chúng.

Để tối đa hóa lãi ròng đồng thời giảm thiểu mức sụt giảm tối đa của vốn tức thời:

--criteria="NetProfit:max,MaxEquityDrawdownPercentages:min"

Nếu muốn tự xác định cách xếp hạng, hãy sử dụng --fitness thay thế. Phương thức GetFitness của cBot trả về một điểm số và quá trình tối ưu hóa giữ lại những lượt chạy có điểm số cao nhất. --fitness và --criteria loại trừ lẫn nhau. Chỉ được chỉ định một trong hai.

Các tùy chọn ngữ cảnh kiểm thử ¶

optimize sử dụng lại các tùy chọn ngữ cảnh kiểm thử của backtest. Bảng dưới đây liệt kê những tùy chọn mà CLI hiện tại hỗ trợ, chức năng của từng tùy chọn và điểm khác biệt giữa hai lệnh nếu có.

Ví dụ ¶

ctrader-cli optimize "C:/test/Sample Trend cBot.algo" \
  --params=C:/test/optimize-params.json \
  --account=1234567 --symbol=EURUSD --timeframe=h1,h2 \
  --start="01/01/2025" --end="01/02/2025" \
  --balance=100000 --data-mode=open --commission=30 --spread=2 \
  --method=grid \
  --criteria="NetProfit:max,MaxEquityDrawdownPercentages:min" \
  --auto-select-best \
  --optres=C:/test/result.optres \
  --passes-dir=C:/test/result-passes \
  --ctid=letstrade --pwd-file=C:/test/password.pwd

Đầu ra ¶

Trong khi chạy, optimize liên tục hiển thị tiến trình trên terminal:

Progress | Loading EURUSD, h1 | 42.00 % |
Progress | Optimization | 37.50 % |

• Tóm tắt – khi hoàn tất, cTrader CLI in tóm tắt lên terminal, gồm tổng số lượt chạy, thời gian đã trôi qua và lượt chạy tốt nhất cùng các số liệu thống kê.
• Tệp kết quả – khi chỉ định --optres, cTrader CLI lưu toàn bộ kết quả vào tệp JSON .optres liệt kê tất cả lượt chạy. Tệp này có cùng định dạng với kết quả tối ưu hóa trong ứng dụng trên máy tính, nên bạn có thể mở hoặc nhập tệp vào giao diện tối ưu hóa của ứng dụng.
• Báo cáo theo lượt chạy – khi chỉ định --passes-dir, cTrader CLI lưu các tệp báo cáo của từng lượt chạy trong thư mục này. Mỗi lượt chạy có một thư mục con chứa các tệp .html, .txt, .json và .cbotset. Tệp .cbotset ghi lại chính xác các giá trị tham số được dùng trong lượt chạy đó.

Nếu không chỉ định cả --optres lẫn --passes-dir, quá trình tối ưu hóa kết thúc và chỉ hiển thị phần tóm tắt.

Kiểm tra việc áp dụng tối ưu hóa có chính xác hay không ¶

Sau khi chạy, hãy kiểm tra xem những tham số dự định tối ưu hóa có thực sự được đưa vào tìm kiếm hay không.

1. Mở tệp .cbotset của một lượt chạy trong --passes-dir và kiểm tra xem các tham số được tối ưu hóa có thay đổi giữa các lượt chạy, trong khi các tham số cố định hoặc bị bỏ qua vẫn giữ nguyên.
2. Nếu bạn đã thử nhiều khung thời gian, hãy kiểm tra giá trị Chart.Period trong tệp .cbotset của từng lượt chạy. Giá trị này phải khớp với những khung thời gian đã chọn.
3. Mở tệp .optres hoặc nhập tệp vào giao diện tối ưu hóa của ứng dụng trên máy tính để xem lại cấu hình cùng kết quả của tất cả lượt chạy.

Kiểm tra tính hợp lệ và các lỗi thường gặp ¶

Mỗi hàng trong bảng dưới đây cho biết dấu hiệu lỗi, nguyên nhân có thể xảy ra, mã thoát mà cTrader CLI trả về khi gặp lỗi và cách xử lý tiếp theo. cTrader CLI trả về mã thoát khác 0 cho mọi lỗi kiểm tra tính hợp lệ. Vì vậy, tập lệnh có thể dừng ngay khi gặp lỗi đầu tiên mà không cần phân tích thông báo.

Trong bảng, mã thoát là giá trị cTrader CLI trả về cho shell. Các mã số cụ thể không được công bố. Vì vậy, non-zero biểu thị lệnh thất bại nhưng không có mã riêng được công bố; unknown biểu thị lỗi nội bộ, cần chuyển sang bản dựng khác hoặc liên hệ bộ phận hỗ trợ.