模拟盘交易¶
本篇导览
| 项目 | 说明 |
|---|---|
| 目标 | 用实时行情运行策略,信号推送到钉钉/飞书,人工执行实盘 |
| 前置 | 运行回测 |
1. 模拟盘交易¶
模拟盘用实时行情持续运行策略,撮合逻辑与回测一致。它不下真实订单——信号通过 Webhook 推送给你,实盘手动执行。
1. 基本用法¶
from eqlib import run_paper_trade, set_benchmark, run_daily, g
def initialize(context):
g.security = '601398.XSHG'
set_benchmark('000300.XSHG')
run_daily(market_open, time='every_bar')
def market_open(context):
pass # 策略逻辑
result = run_paper_trade(
initialize,
starting_cash=100000,
benchmark='000300.XSHG',
interval=60, # 行情轮询间隔(秒)
)
按 Ctrl+C 停止。停止后返回一个 dict:context、trade_log、recorded_values、session。
定时回调只接收 context 一个参数——写成 def market_open(context, data) 会抛 TypeError,而且触发回调熔断(见 §3)。取数用模块级的 attribute_history() / get_current_data()。
2. 交易信号通知¶
通过钉钉或飞书 Webhook 接收信号通知,按通知里的价格区间手动下单。
2.1 配置 Webhook¶
from eqlib import set_notification_webhook, enable_notification
def initialize(context):
# 钉钉(secret 可选,对应机器人"加签"密钥)
set_notification_webhook(
"dingtalk",
"https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN",
secret="SECxxxxxxxx",
)
# 飞书
# set_notification_webhook(
# "feishu",
# "https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_TOKEN",
# )
enable_notification(["signal"]) # 默认值,可省略
set_notification_webhook(platform, url, secret=None):platform 取 "dingtalk" 或 "feishu";传 None 关闭通知。钉钉加签由库内自动完成(HMAC-SHA256 签名并 URL 编码后拼到 webhook 上)。
enable_notification(events=None):events 接受 "signal" / "queued" / "filled",默认 ["signal"]。"signal" 在策略调用 notify_signal 时发送;"queued"(订单排队)与 "filled"(订单成交,含成交价、数量、佣金、是否部分成交)由引擎在模拟/实盘会话中自动推送。无论配置什么,回测期间都不会发送任何通知。
获取 Webhook
- 钉钉:群设置 → 智能群助手 → 添加机器人 → 自定义。安全设置选"加签"则把密钥传给
secret。 - 飞书:群设置 → 群机器人 → 添加机器人 → 自定义机器人。
2.2 在策略里发信号¶
from eqlib import (
run_paper_trade, set_benchmark, run_daily,
attribute_history, order_value, order_target,
set_notification_webhook, enable_notification, notify_signal,
g,
)
def initialize(context):
set_notification_webhook(
"dingtalk",
"https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN",
secret="SECxxxxxxxx",
)
enable_notification(["signal"])
g.security = "601398.XSHG"
g.fast = 5
g.slow = 20
g.strategy_name = "双均线金叉策略"
set_benchmark("000300.XSHG")
run_daily(market_open, time="every_bar")
def market_open(context):
hist = attribute_history(g.security, g.slow + 5, "1d", ["close"])
if hist is None or len(hist) < g.slow + 1:
return
close = hist["close"]
price = close.iloc[-1]
fast_ma = close.tail(g.fast).mean()
slow_ma = close.tail(g.slow).mean()
prev_fast = close.tail(g.fast + 1).head(g.fast).mean()
prev_slow = close.tail(g.slow + 1).head(g.slow).mean()
if prev_fast <= prev_slow and fast_ma > slow_ma:
notify_signal(
security=g.security,
side="buy",
amount=1000,
current_price=price,
price_range=(price * 0.98, price * 1.02),
strategy_name=g.strategy_name,
trigger_point=f"MA5={fast_ma:.2f} 上穿 MA20={slow_ma:.2f}, 金叉形成",
)
order_value(g.security, context.portfolio.available_cash)
elif prev_fast >= prev_slow and fast_ma < slow_ma:
pos = context.portfolio.positions.get(g.security)
if pos is not None and pos.amount > 0:
notify_signal(
security=g.security,
side="sell",
amount=pos.amount,
current_price=price,
price_range=(price * 0.98, price * 1.02),
strategy_name=g.strategy_name,
trigger_point=f"MA5={fast_ma:.2f} 下穿 MA20={slow_ma:.2f}, 死叉形成",
)
order_target(g.security, 0)
notify_signal(security, side, amount, current_price=None, price_range=None, strategy_name=None, trigger_point=None):side 取 "buy" / "sell";amount 应为 100 的整数倍(A 股整手);返回 True 表示发送成功。未配置 webhook 或未启用 "signal" 事件时直接返回 False,不影响策略运行。
3. 时段门控¶
模拟盘严格按 A 股交易时段(北京时间)运行,时段外主循环空转:
| 时段 | 阶段 | 行为 |
|---|---|---|
| 09:15 之前 | closed | 不取数、不撮合、不跑回调 |
| 09:15–09:25 | auction(集合竞价) | 回调可运行、可挂单,但不撮合 |
| 09:25–15:00 | continuous(连续竞价) | 正常撮合;当日首笔成交等 09:25 竞价结束 |
| 15:00 之后 | after | after_trading_end 钩子跑一次,随后空转 |
规则细节:
- 非交易日(周末/节假日)整天空转,连行情都不拉。
- 竞价期挂单:09:15–09:25 期间挂的订单不参与 09:25 的竞价撮合,按统一的 T→T+1 模型次日成交。
- 无行情不砍单:拿不到报价的股票,订单保持 pending,不会被取消。
- 回调熔断:同一回调(定时函数或
handle_data)连续抛异常 3 次,本次运行内禁用该回调并记 error 日志。进程不会死,但那个回调"安静死亡"——回调里自己兜好异常。 - 调度时刻:
run_daily(f, time="09:45")这类定点回调按真实时钟 ±60 秒匹配,每天每个时间点最多跑一次。interval设得明显大于 60 秒可能错过匹配窗口;time="every_bar"每次轮询都跑,不受此影响。 before_trading_start钩子在每天任何定时函数和handle_data之前运行(context.current_dt固定为当天 09:30),与回测的顺序一致。
完整参数说明见 回测引擎 API 参考 与 通知 API 参考。端到端示例见 examples/12_paper_trade.py。