การทำงานกับ cBot¶

บทความนี้อธิบายวงจรการทำงานของ cBot ใน cTrader CLI เรียนรู้วิธีเรียกใช้ cBot จากเทอร์มินัล แสดงรายการและหยุดอินสแตนซ์ที่กำลังทำงาน โฮสต์ cBot บน VPS หรือเซิร์ฟเวอร์คลาวด์ด้วย Docker และทำ backtesting กับข้อมูลย้อนหลัง

ข้อกำหนดเบื้องต้น ¶

• ได้ติดตั้ง cTrader CLI แล้ว
• เตรียม cTrader ID ไฟล์ข้อมูลประจำตัว และหมายเลขบัญชีของคุณให้พร้อม
• ส่งออก cBot เป็นไฟล์ .algo ที่คอมไพล์สำหรับ .NET 8 แล้ว

อ่านข้อมูลเมตาของ cBot ¶

ก่อนเรียกใช้ cBot ให้ใช้ metadata เพื่อแสดงรายการพารามิเตอร์ที่ cBot รองรับ ผลลัพธ์จะแสดงชื่อและชนิดของแต่ละพร็อพเพอร์ตีของ cBot

ctrader-cli metadata <path-to-algo-file>

ใช้ชื่อพารามิเตอร์ที่แสดงในผลลัพธ์ข้อมูลเมตาเมื่อส่งพารามิเตอร์ผ่านบรรทัดคำสั่งหรือไฟล์ .cbotset

เรียกใช้ cBot ¶

เริ่ม cBot ด้วย run พาธไปยังไฟล์ .algo เป็นอาร์กิวเมนต์แรก ต้องระบุ --account, --symbol และ --period

ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>

ส่งพารามิเตอร์ได้สามวิธี

มีตัวเลือกเสริมสองรายการที่สำคัญสำหรับการเรียกใช้แบบไม่มีผู้ดูแล

เรียกใช้ cBot บน VPS หรือเซิร์ฟเวอร์คลาวด์ ¶

เครื่องมือที่ทำงานผ่านเทอร์มินัลอย่างเดียวสามารถทำงานบนเครื่อง Linux ขนาดเล็กได้อย่างมีประสิทธิภาพ จึงสามารถเรียกใช้ cBot อย่างต่อเนื่องด้วยต้นทุนที่ต่ำกว่าการใช้คอมพิวเตอร์เดสก์ท็อป การใช้ Docker image ของ cTrader CLI เป็นวิธีที่ย้ายไปใช้งานในสภาพแวดล้อมอื่นได้สะดวกที่สุด

ดาวน์โหลด image ล่าสุด:

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

เรียกใช้ cBot ในคอนเทนเนอร์ ตัวเลือก --mount เชื่อมโยงโฟลเดอร์บนเครื่องโฮสต์กับตำแหน่งภายในคอนเทนเนอร์ ส่วนตัวเลือก -e ใช้ส่งการตั้งค่าผ่านตัวแปรสภาพแวดล้อม:

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

เริ่มจากแอป cTrader บนเดสก์ท็อป ¶

คุณไม่จำเป็นต้องเชี่ยวชาญการใช้บรรทัดคำสั่งก็สามารถใช้ประโยชน์จาก cTrader CLI ได้

1. ในแอป cTrader บนเดสก์ท็อป ให้เตรียม cBot พร้อมพารามิเตอร์ที่ต้องการ
2. คลิกขวาที่อินสแตนซ์ cBot ในเครื่อง แล้วเลือก เริ่มในโปรเซสภายนอก cTrader CLI จะเริ่มทำงานโดยอัตโนมัติและเรียกใช้อินสแตนซ์นั้นอย่างเป็นอิสระ
3. ปิดแอปบนเดสก์ท็อปเพื่อลดการใช้ทรัพยากร CPU และ RAM cBot จะยังคงทำงานอยู่ในโปรเซส cTrader CLI

แสดงรายการและหยุด cBot ¶

แสดงอินสแตนซ์ cBot ที่กำลังทำงานอยู่ในบัญชี:

ctrader-cli cbots --ctid=letstrade --password=secret --account=1234567 -q

หยุดอินสแตนซ์ที่กำลังทำงานโดยใช้ตัวระบุที่แสดงในผลลัพธ์ของ run:

ctrader-cli stop --ctid=letstrade --password=secret --account=1234567 -q --instance=<instance-id>

หากต้องการหยุด cBot ที่กำลังทำงานทั้งหมดพร้อมกัน ให้เปิดเชลล์แบบโต้ตอบแล้วเรียกใช้ stop all yes โปรเซส cTrader CLI จะสิ้นสุดเมื่ออินสแตนซ์สุดท้ายหยุดทำงาน

ทำ backtesting ของ cBot ¶

ทดสอบ cBot ด้วยข้อมูลย้อนหลังโดยใช้ backtest พาธไปยังไฟล์ .algo เป็นอาร์กิวเมนต์แรก และอาจตามด้วยไฟล์ .cbotset ซึ่งไม่บังคับ การทดสอบยังต้องระบุสัญลักษณ์ กรอบเวลา และช่วงวันที่:

ctrader-cli backtest <path-to-algo-file> [<path-to-cbotset-file>] --account=<account-id> --symbol=<symbol> --period=<period> --start=<start-date> --end=<end-date> --data-mode=<data-mode>

ตัวเลือกสภาพแวดล้อมการทดสอบ ¶

ตัวเลือกสภาพแวดล้อมการทดสอบอยู่หลังรายการ backtest ในเอกสารอ้างอิง CLI ต้องระบุเพียง --start, --end และ --data-mode ตัวเลือกเสริมใช้กำหนดยอดคงเหลือเริ่มต้น ค่าคอมมิชชัน สเปรด แหล่งข้อมูล และไฟล์รายงาน

โหมดข้อมูล ¶

ตัวอย่างการใช้งาน ¶

ทำ backtesting ของ cBot ตัวอย่างโดยใช้ไฟล์พารามิเตอร์ .cbotset เพียงไฟล์เดียว:

ctrader-cli backtest "C:/test/sample martingale.algo" C:/test/special-parameters.cbotset \
  --ctid=letstrade --pwd-file=C:/test/password.pwd --account=1234567 --symbol=EURUSD --period=h1 \
  --start="01/01/2025 12:34" --end="31/01/2025 20:56" \
  --balance=10000 --commission=30 --commission-type=UsdPerMillionUsdVolume --spread=1 --data-mode=m1

ผลลัพธ์ backtesting ¶

cTrader CLI จะแสดงความคืบหน้าในเทอร์มินัลอย่างต่อเนื่อง และแสดงสรุปเมื่อเสร็จสิ้น ผลลัพธ์ทั้งหมดอยู่ในโฟลเดอร์ Backtesting ข้างไฟล์ .algo โดยมีโฟลเดอร์ย่อยแยกสำหรับการเรียกใช้แต่ละครั้ง:

…/data/{cBotName}/{BacktestingInstanceID}/Backtesting

--report และ --report-json จะบันทึกรายงานไว้ในพาธที่ระบุเพิ่มเติมจากโฟลเดอร์ข้างต้น

พฤติกรรมของ Algo API ใน cTrader CLI ¶

สมาชิกบางส่วนของ cTrader Algo API มีพฤติกรรมแตกต่างออกไปเมื่อ cBot ทำงานใน cTrader CLI เพราะไม่มีส่วนติดต่อแบบกราฟิก