anti-gambling-trader-tw 自动化交易脚手架:PaperBroker 默认模拟与四重安全门,不花一分钱测试你的策略
anti-gambling-trader-tw 自动化交易脚手架:PaperBroker 默认模拟与四重安全门,不花一分钱测试你的策略
🧾 anti-gambling-trader-tw 是一个免费开源的投资反诈、交易统计与自动化交易程序开发工具。它的 scaffold(脚手架)命令可以一条指令生成一套完整可执行的个人自动化交易程序项目:默认启用 PaperBroker 纸上模拟,并内建四重安全门——你在测试策略时,全程不碰真钱。
下面带你从零走完这条安全路径:生成项目 → 填策略 → 纸上跑通 → 理解安全门 → 再决定要不要接真实券商。
一、自动化交易脚手架是什么:一条指令生成整套可运行程序
很多新手写交易程序时,要自己搭目录、接行情、写下单接口、画图表,繁琐且容易出错。anti-gambling-trader-tw 的脚手架(core/scaffold/generator.py)会替你生成一整套自包含项目,装好依赖后 python main.py 就能直接跑纸上模拟:
| 生成文件 | 职责 |
|---|---|
main.py |
主程序,默认纸面模拟;真实下单总开关 ALLOW_LIVE_TRADING 默认关闭 |
strategy.py |
你的交易规则(进出场条件待你填写,含默认停损/停利逻辑) |
broker_lib.py |
自包含券商库(交易接口 + PaperBroker,零外部依赖) |
broker_setup.py |
券商选择器,默认返回 PaperBroker |
brokers/ |
真实券商接入框架(待填 API key 与实现) |
charting.py |
图表模块(四选一的开源图表库) |
data_feed.py |
行情数据源(回测/即时统一接口,内置可复现的演示 K 线) |
config.example.yaml |
配置模板(含风控参数与安全门字段) |
requirements.txt / .gitignore |
依赖清单;自动排除 config.yaml、.env 等敏感文件 |
两个值得注意的设计细节:
- 自包含:
broker_lib.py由脚手架直接把本体的券商接口与PaperBroker源码合并进你的项目(core/scaffold/generator.py),项目放到任何目录都能独立运行,不会出现ModuleNotFoundError。 - 输入校验:项目名与标的代号在生成前会经过严格正则校验,拒绝引号、路径分隔、
..等危险字符,杜绝路径穿越与代码注入(core/scaffold/generator.py)。
二、三步快速上手:安装、生成、运行纸上模拟
1️⃣ 克隆并安装本工具
git clone https://gitcode.com/gh_mirrors/an/anti-gambling-trader-tw
cd anti-gambling-trader-tw
pip install -e .
核心引擎是纯 Python 标准库,零外部依赖;要求 Python 3.10+。
2️⃣ 查看可选项并生成项目
# 看看有哪些券商 / 图表可选
anti-gambling-trader brokers
anti-gambling-trader charts
# 生成项目(建议带 --from-analysis,把交易纪录的统计裁决嵌入项目)
anti-gambling-trader scaffold --name my_bot --broker paper \
--chart lightweight --market crypto --symbols "BTCUSDT,ETHUSDT" \
--from-analysis my_trades.csv
--from-analysis 会先用 core/cli.py 的分析流程读取你的交易纪录,把「裁决等级」和「新手阶段分流」结果写进生成项目的配置与 README。如果分析判定你的策略更像赌博,生成项目的 main.py 会默认禁用真实下单,并在项目 README 里写上一段劝退提醒——这是保护你,不是限制你。
3️⃣ 跑起来(默认纸上模拟,不碰真钱)
cd my_bot
pip install -r requirements.txt
python main.py # 用 PaperBroker 跑一遍 120 根演示 K 线,并产出图表
跑完会输出绩效摘要(最终权益、成交笔数),并生成 chart.html 图表。接下来你要做的只有一件事:打开 strategy.py,把进出场规则填进去。
💡 脚手架的提醒很直白:如果你连「明确、可量化的进出场规则」都写不出来,那说明你的交易可能凭感觉,而不是有方法。
三、PaperBroker 纸上模拟:像真撮合一样,但花不了钱
PaperBroker(core/broker/paper.py)不是摆设,而是一个完整可用的模拟券商:
- 真实撮合逻辑:市价单按滑点成交、限价单按限价成交;资金不足会拒单;默认只支持做多,卖出超过持仓直接拒单。
- 仓位核算严谨:买入加仓走加权平均成本,反向超量翻仓时以新成交价建立新仓位——停损/停利不会被旧均价带偏。
- 成本可配置:在
config.yaml里调整起始资金、手续费率与滑点:
paper:
starting_cash: 1000000 # 起始资金
fee_rate: 0.001 # 每笔手续费率
slippage: 0.0005 # 市价单滑点率
risk:
max_position_pct: 0.2 # 单一标的最多动 20% 资金
stop_loss_pct: 0.05 # 停损 5%
take_profit_pct: 0.15 # 停利 15%
- 想模拟做空? 需要显式传入
allow_short=True,且它会明确告知你:这是不含借券费、融资利息、保证金的简化模型,估值偏乐观,不可当真实做空绩效预期。 - 留痕可分析:每笔模拟成交都记录在
fills里,方便事后复盘。
一句话:先用它把整套程序跑到满意为止,再考虑接真实券商。
四、四重安全门详解:为什么真实下单被默认封死
anti-gambling-trader-tw 对「真钱」的保守程度是刻意为之。生成项目的模板(core/scaffold/templates.py)里写死了四道闸门:
| # | 安全门 | 内容 | 失败时行为 |
|---|---|---|---|
| 1 | 默认纸上模拟 | 生成项目默认用 PaperBroker,完整模拟撮合但不碰真钱 |
— |
| 2 | 完整阶段联动 | 只有完整分析(含样本外验证、币别与回撤基准)分流到 tiny_live_validation 阶段时,配置才可能同时写入 stage_code: tiny_live_validation 与 allow_live_trading: true |
其他任何阶段一律封锁 |
| 3 | Runtime 多重硬闸 | 运行时重新校验:ALLOW_LIVE_TRADING 常量、risk.i_have_read_disclaimer: true、anti_gambling.allow_live_trading 必须为布尔 true、stage_code 必须精确匹配,全部通过才调用券商双重复确认 |
缺字段、类型错误、YAML 损坏一律 fail closed |
| 4 | 历史 replay 不碰真钱 | 内置 main.py 只重放 120 根历史/演示 K 线,一旦侦测到 live broker 会硬性退出,避免把历史信号一次送成多张真单 |
直接终止程序 |
第 3 道闸门还要求你手动在 main.py 里把 ALLOW_LIVE_TRADING 从 False 改成 True——这种「摩擦力」是刻意设计的,逼你在动真钱前停下来想清楚。
即使四道门全过,也只代表程序允许你做极小额验证,不代表策略适合重押或全职交易。
五、14 种券商选项与 4 种图表库
执行 anti-gambling-trader brokers 可查看完整清单(注册表见 core/broker/registry.py、core/broker/registry_tw.py)。所有生成项目一律默认 PaperBroker,真实券商模板需要你自行接线与验证:
| 市场 | 可选 key |
|---|---|
| 全市场 | paper(纸上模拟,默认,完整可用) |
| 台股 / 台期 | shioaji(永丰)、yuanta(元大 SPARK)、fubon(富邦)、kgi(凯基,含美股)、tw_futures(期货类) |
| 美股 / 全球 | ibkr(Interactive Brokers)、alpaca、tradier |
| 加密货币 | binance、okx、bybit、pionex、ccxt(一个接口接 100+ 交易所) |
图表库四选一:lightweight(TradingView 风格)、plotly、mplfinance、echarts,可先跑 anti-gambling-trader chart-preview 生成预览页用浏览器对比挑选。
六、纸上模拟稳定后,如何安全切换到真实交易?
⚠️ 高风险提示:真实金融交易必须自行操作并负全部责任。把未经验证的策略自动化,只会赔得更快。
按生成项目 README 的要求,完整路径是:
- 用
scaffold --from-analysis <完整交易纪录>重新生成,只有阶段为tiny_live_validation时,配置模板才可能写入正确的 stage 与允许旗标; - 复制
config.example.yaml为config.yaml,阅读免责声明后才把risk.i_have_read_disclaimer设为true(不要手动猜改stage_code/allow_live_trading); - 把
main.py的ALLOW_LIVE_TRADING改为True; - 在
brokers/下填写 API key 并完成券商框架的 TODO,在broker_setup.py里把build_broker()改回真实券商实例; - 另写一个只处理最新一根已完成 K 线的 live runner,并接上可验证为即时且无前视的行情来源——因为内置
main.py是历史重放,接 live broker 会直接退出。
每一步少做一分,安全门就保持封锁一分。
七、写在最后
anti-gambling-trader-tw 的定位是一个诚实到不讨喜的工具:它不会告诉你「你会赚钱」,而是先用统计检验你的策略是不是运气,再用脚手架帮你零成本地把策略跑起来。
- 新手从零开始?先看 docs/quickstart.md
- 完整功能与安全门细则?看 docs/user-guide.md 第 9 节「交易程式与真钱安全闸」
- 统计方法怎么算优势与运气?看 docs/methodology.md
本工具为统计分析与教育用途,输出不构成任何投资建议。投资有风险,盈亏自负;过去绩效不代表未来表现。