PTrade量化交易系统新手指南，委托和成交主推函数不会用？看这篇！

几分钟了解PTrade量化系统中，on_order_response(可选)-委托主推/on_trade_response(可选)-成交主推用法！

on_order_response(可选)-委托主推

on_order_response(context, order_list)

on_order_response是PTrade量化交易系统中的一个可选回调函数，用于实时接收和处理委托订单的状态变化信息。它的核心作用是实现事件驱动的委托状态监控，让策略能够第一时间响应订单状态的变化（如已报、已成、废单等）。

核心价值：为什么使用它？

相较于传统的轮询方式（在handle_data中反复调用get_order()查询状态），on_order_response具有显著优势：

1.实时性更高：它由系统在委托状态变化时主动推送触发，是毫秒级的实时响应，速度远快于定期查询。

2.效率更优：无需编写循环轮询代码，系统自动推送事件，策略逻辑更简洁高效。

函数定义与参数

使用场景

该函数仅在交易模块可用，对接jz_ufx不支持该函数

函数说明

该函数会在委托主推回调时响应，比引擎、get_order()和get_orders()函数更新Order状态的速度更快，适合对速度要求比较高的策略。

注意事项：

目前可接收股票、可转债、ETF、LOF的主推数据。

当接到策略外交易产生的主推时(需券商配置默认不推送)，由于没有对应的Order对象，主推信息中order_id字段赋值为""。

当主推先于委托应答返回时，由于无法根据entrust_no匹配对应的Order对象，主推信息中order_id字段赋值为""。

当在主推里调用委托接口时，需要进行判断处理避免无限迭代循环问题。

当券商配置接收策略外交易产生的主推且策略调用set_parameters()并设置receive_other_response="1"时， 策略中将接收非本交易产生的主推。

当策略调用set_parameters()并设置receive_cancel_response="1"， 策略接收到撤单成交主推时，主推信息中的order_id为买入或卖出委托Order对象的order_id，entrust_no为撤单委托的委托编号。

撤单委托主推信息中成交数量均处理为正数。

参数

context: Context对象，存放有当前的账户及持仓信息；

order_list：一个列表，当前委托单发生变化时，发生变化的委托单列表。委托单以字典形式展现，内容包括：'entrust_no'(委托编号), 'error_info'(错误信息), 'order_time'(委托时间), 'stock_code'(股票代码), 'amount'(委托数量), 'price'(委托价格), 'business_amount'(成交数量), 'status'(委托状态), 'entrust_type'(委托类别), 'entrust_prop'(委托属性), 'order_id'(Order对象编号)；

on_trade_response(可选)-成交主推

on_trade_response(context, trade_list)

on_trade_response是PTrade量化交易系统中的成交回报主推函数，与on_order_response（委托主推）并列，共同构成事件驱动的实时交易监控体系。

核心作用：成交即响应

它的核心作用是：当策略的任何委托单发生成交（包括部分成交或全部成交）时，系统会立即主动推送消息并触发该函数。

这使得策略能够对“成交”这一事件做出毫秒级的实时反应，远快于在handle_data中定时轮询get_trades()的方式。

使用场景

该函数仅在交易模块可用

函数说明

该函数会在成交主推回调时响应，比引擎和get_trades()函数更新Order状态的速度更快，适合对速度要求比较高的策略。

注意事项：

目前可接收股票、可转债、ETF、LOF的主推数据。

当接到策略外交易产生的主推时(需券商配置默认不推送)，由于没有对应的Order对象，主推信息中order_id字段赋值为""。

当主推先于委托应答返回时，由于无法根据entrust_no匹配对应的Order对象，主推信息中order_id字段赋值为""。

当在主推里调用委托接口时，需要进行判断处理避免无限迭代循环问题。

当券商配置接收策略外交易产生的主推且策略调用set_parameters()并设置receive_other_response="1"时， 策略中将接收非本交易产生的主推。

当策略调用set_parameters()并设置receive_cancel_response="1"， 策略接收到撤单成交主推时，主推信息中的order_id为买入或卖出委托Order对象的order_id，entrust_no为撤单委托的委托编号。

撤单成交主推信息中成交数量均处理为正数。

withdraw_no(撤单原委托号)仅在撤单成交主推信息中才有对应值，在委托成交主推中该字段赋'0'默认值。

撤单成交主推信息中entrust_no在异构柜台情况下与withdraw_no一致，因此策略中请勿将该字段作为撤单成交主推信息的关联字段。

参数

context: Context对象，存放有当前的账户及持仓信息；

trade_list：一个列表，当前成交单发生变化时，发生变化的成交单列表。成交单以字典形式展现，内容包括：'entrust_no'(委托编号)，'business_time'(成交时间)，'stock_code'(股票代码)，'entrust_bs'(委托方向)，'business_amount'(成交数量)，'business_price'(成交价格)，'business_balance'(成交额)，'business_id'(成交编号)，'status',(委托状态)(对接jz_ufx、ctp期货柜台该字段为空)，'order_id'(Order对象编号)，'cancel_info'(废单原因)，'withdraw_no'(撤单原委托号)，'real_type' (成交类型编号)，'real_status'(成交状态编号)；

智能交易可能因系统、通讯等原因无法正常使用或无法按照您的设置价格发出委托指令及完成成交，最终成交价格及数量以交易所、登记结算机构等记录为准。请密切关注交易回报情况及条件单设置情况。以上信息仅供参考，不构成对委托指令成交的承诺，不构成投资建议，不构成收益或避免损失的承诺。请您务必仔细阅读相关风险提示及协议，了解各类智能交易功能的区别及不同风险，审慎决策是否使用相关功能。

投资有风险，入市需谨慎！

我司30多年发展历史上市券商平台，可提供：

1.QMT/PTrade量化系统，免费使用，支持券商极速交易服务配合使用；

2.现在新开户交易佣金优惠，股票/ETF/可转债/港股通/国债逆回购等惊喜费率；

3.支持创业板/科创板/北交所/港股通/融资融券等业务权限开通；

4.正在进行AI投ETF/选好股/选好基金等AI投顾工具30天免费体验活动；

5.智能条件单，网格交易，预约打新等功能支持；

6.新客理财领取（限额），赠送Level-2十档行情（佣金宝APP）活动进行中；

7.支持底仓增强策略提供，内置多种交易策略，适合长期持仓用户做自动日内回转交易；

8.88开头，可选数字靓号开户；

更多需求了解，欢迎点击文章上方“问一问”，或文章下方微信+电话，直接联系沟通需求！