RiskManager - 事前风控管理模块¶

VeighNa Station加载¶

启动登录VeighNa Station后，点击【交易】按钮，在配置对话框中的【应用模块】栏勾选【RiskManager】。

脚本加载¶

在启动脚本中添加如下代码：

# 写在顶部
from vnpy_riskmanager import RiskManagerApp

# 写在创建main_engine对象后
main_engine.add_app(RiskManagerApp)

活动委托检查（ActiveOrderRule）¶

限制同时处于活动状态（提交中 / 未成交 / 部分成交）的委托数量。

当一笔委托状态变为非活动（全部成交 / 已撤销 / 拒单）时，计数器自动释放。

每日上限检查（DailyLimitRule）¶

限制日内累计的委托、撤单和成交笔数，支持全汇总（所有合约合计）和单合约两个维度的独立上限。

六项上限中有任意一项达到即拦截后续委托。计数器每日重置。

重复报单检查（DuplicateOrderRule）¶

防止策略因逻辑错误在短时间内反复发送完全相同的委托请求。

规则将每笔委托请求格式化为字符串（合约代码 + 委托类型 + 方向 + 开平 + 数量 @ 价格），统计相同请求的重复次数。

委托一旦被拦截，计数器不再增加（避免无限增长），用户需手动排查策略逻辑。

委托规模检查（OrderSizeRule）¶

限制单笔委托的数量和名义价值，防止因参数错误导致异常大单。

委托名义价值的计算公式为：数量 × 价格 × 合约乘数。由于合约乘数需要从CTP等接口推送的合约信息中获取，仅当合约信息已缓存且为限价单时才会执行价值检查。

委托指令检查（OrderValidityRule）¶

验证委托本身的合法性，确保发送到交易所的委托不会被拒单。检测项包括：

1. 合约存在性：委托的目标合约代码是否在系统中可查到

2. 价格精度：委托价格是否为合约最小变动价位（pricetick）的整数倍

3. 数量范围：委托数量是否在合约允许的[min_volume, max_volume]区间内

该规则除公共的active参数外，无其他用户可配置参数。默认启用，建议始终保持开启，避免低级的委托格式错误。

规则模板¶

所有风控规则继承RuleTemplate基类，其结构与CtaTemplate高度一致：

from vnpy_riskmanager.template import RuleTemplate
from vnpy.trader.object import OrderRequest, OrderData, TradeData, TickData


class MyCustomRule(RuleTemplate):
    """自定义风控规则"""

    # 规则名称（UI显示名，同时作为配置主键，需全局唯一）
    name: str = "我的自定义规则"

    # 参数字段 → UI显示名
    parameters: dict[str, str] = {
        "my_limit": "自定义上限",
    }

    # 变量字段 → UI显示名
    variables: dict[str, str] = {
        "my_count": "自定义计数",
    }

    def on_init(self) -> None:
        """初始化（构造函数中自动调用）"""
        self.my_limit: int = 100
        self.my_count: int = 0

    def check_allowed(self, req: OrderRequest, gateway_name: str) -> bool:
        """
        检查是否允许此笔委托。
        返回 True = 放行，返回 False = 拦截并输出日志。
        """
        if self.my_count >= self.my_limit:
            self.write_log(f"自定义计数{self.my_count}达到上限")
            return False
        return True

    def on_order(self, order: OrderData) -> None:
        """收到委托回报时触发"""
        self.my_count += 1
        self.put_event()

    def on_trade(self, trade: TradeData) -> None:
        """收到成交回报时触发"""
        pass

    def on_tick(self, tick: TickData) -> None:
        """收到行情Tick时触发"""
        pass

    def on_timer(self) -> None:
        """每秒定时触发"""
        pass

RuleTemplate方法速查¶

注意：只有实际重写了on_order / on_trade / on_tick / on_timer的规则才会收到对应的事件推送。RiskEngine会通过needs_callback()方法自动检测，避免不必要的事件分发开销。

放置自定义规则¶

对于用户自行开发的风控规则，需要放到VeighNa Trader运行时目录下的rules目录中，才能被识别加载。具体的运行时目录路径，可以在VeighNa Trader主界面顶部的标题栏查看。该目录通常与.vntrader文件夹平级，若不存在rules目录，需自行创建。

对于在Windows上默认安装的用户来说，放置规则的rules目录路径通常为：

C:\Users\Administrator\rules

其中Administrator为当前登录Windows的系统用户名。

请注意：

• 显示在UI左侧的是规则类的name属性，而不是规则文件名；

• 规则类名必须以Rule结尾（例如MyCustomRule），否则不会被加载。

RiskEngine启动时会自动扫描并加载该目录下符合条件的规则类，同时也会加载vnpy_riskmanager.rules包内的内置规则。两个来源的规则会合并显示在UI左侧的规则列表中。

如规则文件发生修改，重新启动VeighNa Trader即可加载新版本。

Cython加速¶

对于性能敏感的场景（如高频交易中大量事件回调），可以将.py编译为.pyd（Windows）或.so（Linux）。vnpy_riskmanager.rules目录下已经提供了每条内置规则的Cython版本（.pyx文件），用户自定义规则也可以同样处理。

RiskEngine在扫描规则时会同时匹配*.py、*.pyd、*.so后缀的文件，无需额外配置。若同一规则类同时存在纯Python与编译版本，后加载的版本会覆盖先加载的版本（扫描顺序为py → pyd → so）。

修改参数¶

在UI界面左侧列表中选择需要修改的规则，点击右下角的【修改风控参数】按钮：

弹出参数编辑对话框，各参数根据类型自动匹配输入控件：

• bool类型：下拉框（True / False），如active开关

• int类型：整数微调框

• float类型：浮点数微调框（6位小数精度）

修改后点击【确定】保存并立即生效。参数会自动持久化到运行时目录下.vntrader文件夹中的risk_manager_setting.json文件，下次启动自动恢复。

启停规则¶

每条规则都有active参数（默认True）。设为False后该规则不再参与委托拦截检查。可在【修改风控参数】对话框中，将active对应的下拉框改为False后保存。

建议日常保持全部规则启用。如需临时关闭某条规则以排查问题，关闭后应立即恢复。