algoderiv/agent-skills/wtpy

WonderTrader/wtpy Development Guide

综合 WonderTrader 官方文档（Read the Docs）、社区学习笔记（WonderTrader-Learning-Notes）和非官方整理文档（docs_wondertrader）三大来源，为 wtpy/WonderTrader 量化交易开发提供一站式参考。

When to Use This Skill

This skill should be triggered when:

• 使用 wtpy (WonderTrader Python 框架) 开发量化策略
• 使用 WonderTrader C++ 核心进行高频/极速交易开发
• 配置和运行 CTA/SEL/HFT/UFT 引擎
• 进行策略回测、仿真交易或实盘交易
• 处理行情数据（DSB/CSV 转换、数据录制、历史数据管理）
• 配置和使用 WtMonSvr 监控服务或 WtStudio
• 对接 CTP/openctp/XTP 等交易和行情接口
• 开发自定义执行器（ExtExecuter）或行情解析器（ExtParser）
• 排查 WonderTrader 常见问题（编译、配置、运行）

Quick Reference

Installation

pip install wtpy --upgrade

Backtest (CTA)

from wtpy import WtBtEngine, EngineType
from wtpy.apps import WtBtAnalyst
engine = WtBtEngine(EngineType.ET_CTA)
engine.init('../common/', "configbt.yaml")
engine.configBacktest(202201100930, 202202011500)
engine.commitBTConfig()
straInfo = StraDualThrust(name='pydt_cu', code="SHFE.cu.HOT",
    barCnt=50, period="m5", days=30, k1=0.1, k2=0.1, isForStk=False)
engine.set_cta_strategy(straInfo)
engine.run_backtest()
analyst = WtBtAnalyst()
analyst.add_strategy("pydt_cu", folder="./outputs_bt/pydt_cu/",
    init_capital=500000, rf=0.02, annual_trading_days=240)
analyst.run()
engine.release_backtest()

Live Trading (CTA)

from wtpy import WtEngine, EngineType
env = WtEngine(EngineType.ET_CTA)
env.init('../common/', "config.yaml")
straInfo = StraDualThrust(name='pydt_au', code="SHFE.au.HOT",
    barCnt=50, period="m5", days=30, k1=0.2, k2=0.2, isForStk=False)
env.add_cta_strategy(straInfo)
env.run()

Contract Code Format

• 期货合约: CFFEX.IF.2306
• 期货主力: CFFEX.IF.HOT
• 商品期权: CFFEX.IO2007.C.4000
• 股票: SSE.STK.600000
• ETF期权: SSE.ETFO.10003961

Trading Engines

Reference Files

This skill includes comprehensive documentation in references/:

Getting Started & Architecture

• getting-started-official.md - 官方快速入门（安装、demo运行、回测分析）
• getting-started-notes.md - 社区学习笔记（版本选择、策略编写、环境部署、回测与实盘详解）
• architecture.md - 架构分析（信号与交易解耦、策略组、风控管理）

Strategy Development

• strategies.md - 经典策略实现（DualThrust、ATR、菲阿里四价、空中花园等）
• api.md - 策略 API 详解（数据接口、交易接口、信号接口）及行情/交易接口对接

Configuration & Data

• configuration.md - 配置文件详解（configbt.yaml、config.yaml、actpolicy.yaml、executers.yaml 等）
• data-tools.md - 数据工具（WtDataHelper、CSV/DSB 转换、Tick数据处理）
• data-management.md - 数据管理（WtDtServo、ExtDataLoader/Dumper、历史数据处理、WtDHFactory）

Advanced Development

• advanced.md - 进阶开发（ExtParser、ExtExecuter、C++开发环境搭建、自定义数据存储）
• wtcpp-modules.md - C++ 模块详解（QuoteFactory、CTA/HFT仿真、下单流程、配置文件源码分析）
• source-analysis.md - 源码解析（回测框架、执行单元、HFT引擎、CTA引擎、信号执行流程）

Operations & Troubleshooting

• tools-console.md - Web 控制台与 WtStudio 使用手册（监控、调度、回测查看、参数优化）
• faq.md - 常见问题（引擎选择、合约代码规则、openctp 对接、CTA 下单接口详解）

Documentation Sources

Key Resources

• GitHub (C++): https://github.com/wondertrader/wondertrader
• GitHub (Python): https://github.com/wondertrader/wtpy
• PyPI: https://pypi.org/project/wtpy/
• QQ群: 610730738

Notes

• This skill was consolidated from three separate documentation sources
• Reference files preserve the original structure and code examples
• Content is primarily in Chinese (中文), matching the original documentation
• Code examples include both Python (wtpy) and C++ (WonderTrader core) implementations