NautilusTrader 追踪限价止损单Trailing-Stop-Limit Order完全指南原理、参数与源码实现【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader导读追踪限价止损单Trailing-Stop-Limit是 NautilusTrader 九种标准订单类型中两种条件追踪订单之一它在市场价格朝有利方向移动时始终让触发价与市场价保持固定偏移并在触发后释放一张限价单Limit order且该限价单的价格同样随市场同步更新。本文以 NautilusTrader 官方概念文档为核心结合crates/model、crates/execution与crates/common中的真实源码系统讲解其订单模型、工厂 API、Rust/Python 双语言创建方法、触发与限价计算算法、校验规则以及实盘/模拟盘中的行为边界帮助你在策略中正确使用这一订单类型并理解底层执行机制。什么是 Trailing-Stop-Limit 订单按照官方概念文档 orders/trailing_stop_limit.md 的定义Trailing-Stop-Limit 订单具有以下核心特征它属于条件订单Conditional order在 FIX 协议中对应OrdType 404Stop Limit叠加 trailing peg 字段——FIX 没有为追踪止损定义独立的OrdType因此 NautilusTrader 在 FIX 映射中将其建模为4Stop Limit trailing peg参见 orders/index.md 的 FIX OrdType 映射表。在订单激活并开始追踪后其触发价始终与适用的市场价格保持一个固定偏移trailing offset。当市场价格朝有利方向移动时触发价随之更新只朝有利方向收紧绝不回退当价格反向穿越触发价时订单被触发。触发后释放的不是市价单而是一张限价单。这张限价单的价格同样由limit_offset相对市场价格计算得出并随市场移动而更新直到触发那一刻为止。与纯 Trailing-Stop-Market释放市价单不同Trailing-Stop-Limit 把出场执行限定在指定的最差可接受成交价之上代价是在快速反转行情中释放出的限价单可能无法成交从而让仓位继续暴露在市场风险之下。这与 Stop-Limit 的固有限制一致——文档 Use cases 一节对此有明确说明。适用场景动态追踪保护 最差成交价约束官方文档给出的适用场景非常聚焦为仓位提供动态追踪保护同时限定一个最差可接受成交价。典型用法是保护浮盈仓位行情上涨时买入止损单或行情下跌时卖出止损单的触发价跟随市场抬高/压低锁定部分利润而一旦触发限价单保证你不会在更差的价格成交。需要警惕的是正如文档与源码都强调的触发后的限价单在快速反转时可能不成交这与 stop_limit.md 中 Stop-Limit 的风险一致。若你希望触发后必定成交应选用 trailing_stop_market.md。此外如果目标交易场所venue不原生支持追踪止损NautilusTrader 的OrderEmulator可以在本地模拟该订单类型设置emulation_trigger后本地模拟器会在触发条件满足时将其转换为LIMIT订单走正常风控与执行路径详见 emulated.md 中可模拟订单类型表格TRAILING_STOP_LIMIT的释放类型为LIMIT。使用 OrderFactory 创建 Trailing-Stop-Limit 订单官方文档强调所有示例订单都应在Strategy上下文中通过工厂创建——Python 端暴露为self.order_factoryRust 端暴露为self.order()。工厂会自动分配 trader/strategy ID、生成 client order ID 与初始化 ID、记录初始时间戳并为所选订单类型应用默认值见 orders/index.md 的 Order factory 一节。官方示例Currenex FX ECN 上的 AUD/USD 买入追踪限价止损以下示例在 Currenex FX ECN 上以 0.71000 USD 的限价买入 1,250,000 AUD/USD在 0.72000 USD 处激活随后以距当前卖价 0.00100 USD 的偏移进行追踪GTC 永久有效use nautilus_model::{ enums::{OrderSide, TimeInForce, TrailingOffsetType, TriggerType}, identifiers::InstrumentId, types::{Price, Quantity}, }; use rust_decimal_macros::dec; use ustr::Ustr; let order self.order().trailing_stop_limit( InstrumentId::from(AUD/USD.CURRENEX), OrderSide::Buy, Quantity::from(1_250_000), Price::from(0.71000), // limit price dec!(0.00050), // limit_offset dec!(0.00100), // trailing_offset Some(TrailingOffsetType::Price), // optional (default PRICE) Some(Price::from(0.72000)), // activation_price None, // trigger_price (materializes from the offset on the first trail) Some(TriggerType::BidAsk), // optional (default DEFAULT) Some(TimeInForce::Gtc), // optional (default GTC) None, // expire_time Some(false), // post_only (default false) Some(true), // reduce_only (default false) None, // quote_quantity (default false) None, // display_qty None, // emulation_trigger None, // trigger_instrument_id None, // exec_algorithm_id None, // exec_algorithm_params Some(vec![Ustr::from(TRAILING_STOP)]), // tags None, // client_order_id );from decimal import Decimal from nautilus_trader.model import InstrumentId from nautilus_trader.model import OrderSide from nautilus_trader.model import Price from nautilus_trader.model import Quantity from nautilus_trader.model import TimeInForce from nautilus_trader.model import TrailingOffsetType from nautilus_trader.model import TrailingStopLimitOrder from nautilus_trader.model import TriggerType order: TrailingStopLimitOrder self.order_factory.trailing_stop_limit( instrument_idInstrumentId.from_str(AUD/USD.CURRENEX), order_sideOrderSide.BUY, quantityQuantity.from_int(1_250_000), pricePrice.from_str(0.71000), activation_pricePrice.from_str(0.72000), trigger_typeTriggerType.BID_ASK, # -- optional (default DEFAULT) limit_offsetDecimal(0.00050), trailing_offsetDecimal(0.00100), trailing_offset_typeTrailingOffsetType.PRICE, time_in_forceTimeInForce.GTC, # -- optional (default GTC) expire_timeNone, # -- optional (default None) reduce_onlyTrue, # -- optional (default False) tags[TRAILING_STOP], # -- optional (default None) )工厂签名与参数详解Rust 侧工厂方法OrderFactory::trailing_stop_limit的完整签名定义于 crates/common/src/factories/order.rsPython 侧对应类型桩位于 python/nautilus_trader/common/init.pyi。两者参数一一对应要点如下参数类型说明instrument_idInstrumentId交易品种 ID如AUD/USD.CURRENEXorder_sideOrderSideBUY或SELLquantityQuantity订单数量必须为正数pricePrice \| None限价。可省略——若省略限价会在首次追踪更新时由limit_offset物化生成详见下文限价延迟物化limit_offsetDecimal限价相对市场价的偏移量触发前限价随市场同步更新trailing_offsetDecimal触发价相对市场价的追踪偏移量trailing_offset_typeTrailingOffsetType \| None偏移量类型默认PRICEactivation_pricePrice \| None激活价。订单提交后未达到该价格前不启动追踪trigger_pricePrice \| None初始触发价。通常省略由首次追踪从偏移量物化trigger_typeTriggerType \| None触发方法默认DEFAULT等效于BID_ASK的报价行为time_in_forceTimeInForce \| None默认GTC若为GTD则必须提供expire_timeexpire_timeint \| NoneGTD 到期时间Unix 纳秒默认Nonepost_onlybool \| None默认falsereduce_onlybool \| None默认false示例中置true用于只减仓quote_quantitybool \| None默认falsedisplay_qtyQuantity \| None冰山单可见数量默认Noneemulation_triggerTriggerType \| None本地模拟触发类型设置后走OrderEmulatortrigger_instrument_idInstrumentId \| None跨品种触发时指定被监控的品种exec_algorithm_id/exec_algorithm_params算法相关附加执行算法tagsSequence[str] \| None订单标签client_order_idClientOrderId \| None不传则由工厂生成TrailingOffsetType偏移量的四种表达追踪偏移以及限价偏移如何量纲化由TrailingOffsetType决定官方文档 orders/index.md 定义了四种取值PRICE以价格差表示文档示例0.00100USD 即此类BASIS_POINTS以基点百分比表示100 个基点 1%TICKS以最小价格变动单位tick数量表示PRICE_TIERvenue 特定的价格档位。注意文档同时指出TrailingOffsetType缺失None对追踪订单而言是非法的必须在创建时显式提供。源码级解析触发价与限价如何随市场更新理解 Trailing-Stop-Limit 的行为最直接的方式是阅读它的核心计算逻辑。crates/execution/src/trailing.rs中的trailing_stop_calculate函数负责在每次市场更新时为追踪止损单计算新的触发价与限价trailing.rs其关键语义如下只朝有利方向移动单向收紧maybe_move闭包通过better_trigger比较候选价与当前价——OrderSide::Buy时c p才算更优OrderSide::Sell时c p才算更优。候选价若未改善则保持原价不动。也就是说买入追踪止损的触发价只会下移卖出追踪止损的触发价只会上移绝不可能反向放松。偏移量的换算compute闭包Price直接使用偏移量数值BasisPointsbasis * offset / 10_000100 基点 1%Ticksoffset * price_increment以 instrument 的price_increment为 tick 大小其他类型如PriceTier当前计算路径会直接报错。买卖方向的价格基点买入订单以ask卖价为基点并加上偏移得到触发价/限价basis offset卖出订单以bid买价为基点并减去偏移basis - offset。这与文档示例以距当前 ask 0.00100 USD 的偏移追踪买入单完全吻合。触发方法决定市场数据源LastPrice/MarkPrice以最新成交价或标记价为基点Default/BidAsk/LastOrBidAsk买入以 ask、卖出以 bid 为基点Default在本地表现为BidAsk报价行为见 trailing.rs 及测试注释DoubleLast、DoubleBidAsk、IndexPrice等类型当前不被该计算路径支持。触发价缺失时自动物化trigger_price以当前订单携带的触发价为种子只种触发价、绝不使用激活价若触发价尚未物化None首次更新的候选价会直接成为初始触发价——这正是工厂示例中把trigger_price传None的原因文档注释materializes from the offset on the first trail。Trailing-Stop-Limit 专属当订单类型为TrailingStopLimit时函数还会用limit_offset计算候选限价与触发价使用同一市场基点并通过better_limit单向收紧。trailing_stop_calculate返回(new_trigger_price, new_limit_price)二元组None表示对应价格未改善。计算函数在两个执行路径中的调用同一套计算函数被两处核心组件复用见 crates/execution/src 目录模拟撮合引擎crates/execution/src/matching_engine/mod.rs的update_trailing_stop_ordermod.rs每次市场数据更新时用price_increment、订单当前触发价、bid/ask/last调用trailing_stop_calculate若市场数据尚不齐备导致计算失败则记录 debug 日志并等待下一次更新若两个价格均未改善则直接返回否则通过generate_order_updated生成OrderUpdated事件把新触发价/限价应用到订单上。这解释了文档所说限价价格也随市场更新直到触发的落地方式。本地订单模拟器crates/execution/src/order_emulator/emulator.rsemulator.rs 附近对设置了emulation_trigger的追踪止损单同样调用trailing_stop_calculate更新本地触发价并在触发条件满足时将其转换为LIMIT订单释放。TrailingStopLimitOrder 订单模型与校验规则订单类型的底层模型定义于 crates/model/src/orders/trailing_stop_limit.rsTrailingStopLimitOrder结构体包含以下专属字段activation_price: OptionPrice——激活价price: OptionPrice——当前限价触发前随市场更新trigger_price: OptionPrice——当前触发价trigger_type: TriggerType——触发方法limit_offset: Decimal、trailing_offset: Decimal、trailing_offset_type: TrailingOffsetType——两组偏移量及其类型expire_time、is_post_only、display_qty、trigger_instrument_id——通用执行指令is_activated: bool、is_triggered: bool、ts_triggered: OptionUnixNanos——激活/触发状态及触发时间戳。new_checkedtrailing_stop_limit.rs定义了创建时的完整校验规则这些规则同样被 Python 与 Rust 工厂路径共用quantity必须为正数否则报invalidQuantityfor quantity not positivedisplay_qty若提供不得超过quantitytime_in_force为GTD时expire_time必填且不能为零订单元数据必须通过OrderInitialized::new_checked的全部不变量。这些约束都有对应的单元测试佐证同文件mod tests一节如test_quantity_zero_err、test_display_qty_gt_quantity_err、test_gtd_without_expire_err。此外TryFromOrderInitialized实现要求trigger_type、limit_offset、trailing_offset、trailing_offset_type四项在初始化事件中必须存在否则视为谓词违反错误——说明这四项对 Trailing-Stop-Limit 而言是强制字段。值得注意的两个行为细节限价延迟物化has_price()的实现trailing_stop_limit.rs注释明确说明限价在首次追踪更新从limit_offset物化之前可能为None因此依赖 own-book / 价格的路径必须用has_price()判断而非假定限价存在。测试test_has_price_false_until_limit_materializes验证了这一点。更新事件应用update方法trailing_stop_limit.rs在收到OrderUpdated时同步更新price、trigger_price、quantity与leaves_qtyapply方法在收到Triggered事件时置位is_triggered并记录ts_triggered。订单状态机中的位置TRIGGERED状态在订单生命周期中专门覆盖stop-limit、trailing-stop-limit 或 limit-if-touched 订单在 venue 上被触发这一情形见 orders/index.md 的 Order status definitions 表。触发后订单进入TRIGGERED随后由释放出的限价单继续走ACCEPTED → PARTIALLY_FILLED → FILLED或CANCELED/EXPIRED等常规状态流。实战建议与风险提示结合官方文档与源码实现使用 Trailing-Stop-Limit 时有几点值得注意与 Stop-Limit 共享的滑点与不成交风险触发后释放的是限价单快速反转行情下可能挂在盘口无法成交仓位继续保持开放。若必须离场优先于价格保护请改用 Trailing-Stop-Market。reduce_onlyTrue是常见的组合用法示例中即为reduce_only置真配合SimulatedExchange的行为仓位归零时自动撤单、按剩余仓位缩减数量可用于实现只减仓的动态保护逻辑。触发方法与偏移类型的搭配要符合 venue 能力不同 adapter/venue 对条件订单的支持程度不同adapter 可能在提交前拒绝不支持的请求或由 venue 直接拒单见 orders/index.md 的说明。本地模拟路径目前只接受DEFAULT/BID_ASK/LAST_PRICE作为emulation_trigger见 emulated.md。触发价/限价可由偏移自动物化不必同时提供price、trigger_price与两个偏移量省略价格、只给偏移让首次追踪更新自动生成价格是文档示例推荐的简洁写法。追踪只收紧不回退无论行情如何反复触发价与限价都只会朝有利方向单向移动这既是特性也是约束——用它做移动止损保护而不是灵活调整出场价。相关指南Orders 总览订单概念、执行指令、TrailingOffsetType/TriggerType 枚举与 FIX OrdType 映射Emulated orders在无原生支持的 venue 上本地模拟追踪止损Execution 概念订单如何到达 venue、成交如何处理Stop-Limit 指南与本文订单共享限价触发后可能不成交的风险模型Trailing-Stop-Market 指南释放市价单的追踪止损变体。延伸阅读仓库中的关键实现位置订单模型与校验crates/model/src/orders/trailing_stop_limit.rs触发/限价计算算法crates/execution/src/trailing.rs模拟撮合引擎中的追踪更新crates/execution/src/matching_engine/mod.rs本地模拟器调用crates/execution/src/order_emulator/emulator.rsRust 工厂实现crates/common/src/factories/order.rsPython 类型桩python/nautilus_trader/common/init.pyi【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/12 16:08:46 · 阅读 1.2k NautilusTrader 追踪限价止损单（Trailing-Stop-Limit Order）完全指南：原理、参数与源码实现
NautilusTrader 追踪限价止损单Trailing-Stop-Limit Order完全指南原理、参数与源码实现【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader导读追踪限价止损单Trailing-Stop-Limit是 NautilusTrader 九种标准订单类型中两种条件追踪订单之一它在市场价格朝有利方向移动时始终让触发价与市场价保持固定偏移并在触发后释放一张限价单Limit order且该限价单的价格同样随市场同步更新。本文以 NautilusTrader 官方概念文档为核心结合crates/model、crates/execution与crates/common中的真实源码系统讲解其订单模型、工厂 API、Rust/Python 双语言创建方法、触发与限价计算算法、校验规则以及实盘/模拟盘中的行为边界帮助你在策略中正确使用这一订单类型并理解底层执行机制。什么是 Trailing-Stop-Limit 订单按照官方概念文档 orders/trailing_stop_limit.md 的定义Trailing-Stop-Limit 订单具有以下核心特征它属于条件订单Conditional order在 FIX 协议中对应OrdType 404Stop Limit叠加 trailing peg 字段——FIX 没有为追踪止损定义独立的OrdType因此 NautilusTrader 在 FIX 映射中将其建模为4Stop Limit trailing peg参见 orders/index.md 的 FIX OrdType 映射表。在订单激活并开始追踪后其触发价始终与适用的市场价格保持一个固定偏移trailing offset。当市场价格朝有利方向移动时触发价随之更新只朝有利方向收紧绝不回退当价格反向穿越触发价时订单被触发。触发后释放的不是市价单而是一张限价单。这张限价单的价格同样由limit_offset相对市场价格计算得出并随市场移动而更新直到触发那一刻为止。与纯 Trailing-Stop-Market释放市价单不同Trailing-Stop-Limit 把出场执行限定在指定的最差可接受成交价之上代价是在快速反转行情中释放出的限价单可能无法成交从而让仓位继续暴露在市场风险之下。这与 Stop-Limit 的固有限制一致——文档 Use cases 一节对此有明确说明。适用场景动态追踪保护 最差成交价约束官方文档给出的适用场景非常聚焦为仓位提供动态追踪保护同时限定一个最差可接受成交价。典型用法是保护浮盈仓位行情上涨时买入止损单或行情下跌时卖出止损单的触发价跟随市场抬高/压低锁定部分利润而一旦触发限价单保证你不会在更差的价格成交。需要警惕的是正如文档与源码都强调的触发后的限价单在快速反转时可能不成交这与 stop_limit.md 中 Stop-Limit 的风险一致。若你希望触发后必定成交应选用 trailing_stop_market.md。此外如果目标交易场所venue不原生支持追踪止损NautilusTrader 的OrderEmulator可以在本地模拟该订单类型设置emulation_trigger后本地模拟器会在触发条件满足时将其转换为LIMIT订单走正常风控与执行路径详见 emulated.md 中可模拟订单类型表格TRAILING_STOP_LIMIT的释放类型为LIMIT。使用 OrderFactory 创建 Trailing-Stop-Limit 订单官方文档强调所有示例订单都应在Strategy上下文中通过工厂创建——Python 端暴露为self.order_factoryRust 端暴露为self.order()。工厂会自动分配 trader/strategy ID、生成 client order ID 与初始化 ID、记录初始时间戳并为所选订单类型应用默认值见 orders/index.md 的 Order factory 一节。官方示例Currenex FX ECN 上的 AUD/USD 买入追踪限价止损以下示例在 Currenex FX ECN 上以 0.71000 USD 的限价买入 1,250,000 AUD/USD在 0.72000 USD 处激活随后以距当前卖价 0.00100 USD 的偏移进行追踪GTC 永久有效use nautilus_model::{ enums::{OrderSide, TimeInForce, TrailingOffsetType, TriggerType}, identifiers::InstrumentId, types::{Price, Quantity}, }; use rust_decimal_macros::dec; use ustr::Ustr; let order self.order().trailing_stop_limit( InstrumentId::from(AUD/USD.CURRENEX), OrderSide::Buy, Quantity::from(1_250_000), Price::from(0.71000), // limit price dec!(0.00050), // limit_offset dec!(0.00100), // trailing_offset Some(TrailingOffsetType::Price), // optional (default PRICE) Some(Price::from(0.72000)), // activation_price None, // trigger_price (materializes from the offset on the first trail) Some(TriggerType::BidAsk), // optional (default DEFAULT) Some(TimeInForce::Gtc), // optional (default GTC) None, // expire_time Some(false), // post_only (default false) Some(true), // reduce_only (default false) None, // quote_quantity (default false) None, // display_qty None, // emulation_trigger None, // trigger_instrument_id None, // exec_algorithm_id None, // exec_algorithm_params Some(vec![Ustr::from(TRAILING_STOP)]), // tags None, // client_order_id );from decimal import Decimal from nautilus_trader.model import InstrumentId from nautilus_trader.model import OrderSide from nautilus_trader.model import Price from nautilus_trader.model import Quantity from nautilus_trader.model import TimeInForce from nautilus_trader.model import TrailingOffsetType from nautilus_trader.model import TrailingStopLimitOrder from nautilus_trader.model import TriggerType order: TrailingStopLimitOrder self.order_factory.trailing_stop_limit( instrument_idInstrumentId.from_str(AUD/USD.CURRENEX), order_sideOrderSide.BUY, quantityQuantity.from_int(1_250_000), pricePrice.from_str(0.71000), activation_pricePrice.from_str(0.72000), trigger_typeTriggerType.BID_ASK, # -- optional (default DEFAULT) limit_offsetDecimal(0.00050), trailing_offsetDecimal(0.00100), trailing_offset_typeTrailingOffsetType.PRICE, time_in_forceTimeInForce.GTC, # -- optional (default GTC) expire_timeNone, # -- optional (default None) reduce_onlyTrue, # -- optional (default False) tags[TRAILING_STOP], # -- optional (default None) )工厂签名与参数详解Rust 侧工厂方法OrderFactory::trailing_stop_limit的完整签名定义于 crates/common/src/factories/order.rsPython 侧对应类型桩位于 python/nautilus_trader/common/init.pyi。两者参数一一对应要点如下参数类型说明instrument_idInstrumentId交易品种 ID如AUD/USD.CURRENEXorder_sideOrderSideBUY或SELLquantityQuantity订单数量必须为正数pricePrice \| None限价。可省略——若省略限价会在首次追踪更新时由limit_offset物化生成详见下文限价延迟物化limit_offsetDecimal限价相对市场价的偏移量触发前限价随市场同步更新trailing_offsetDecimal触发价相对市场价的追踪偏移量trailing_offset_typeTrailingOffsetType \| None偏移量类型默认PRICEactivation_pricePrice \| None激活价。订单提交后未达到该价格前不启动追踪trigger_pricePrice \| None初始触发价。通常省略由首次追踪从偏移量物化trigger_typeTriggerType \| None触发方法默认DEFAULT等效于BID_ASK的报价行为time_in_forceTimeInForce \| None默认GTC若为GTD则必须提供expire_timeexpire_timeint \| NoneGTD 到期时间Unix 纳秒默认Nonepost_onlybool \| None默认falsereduce_onlybool \| None默认false示例中置true用于只减仓quote_quantitybool \| None默认falsedisplay_qtyQuantity \| None冰山单可见数量默认Noneemulation_triggerTriggerType \| None本地模拟触发类型设置后走OrderEmulatortrigger_instrument_idInstrumentId \| None跨品种触发时指定被监控的品种exec_algorithm_id/exec_algorithm_params算法相关附加执行算法tagsSequence[str] \| None订单标签client_order_idClientOrderId \| None不传则由工厂生成TrailingOffsetType偏移量的四种表达追踪偏移以及限价偏移如何量纲化由TrailingOffsetType决定官方文档 orders/index.md 定义了四种取值PRICE以价格差表示文档示例0.00100USD 即此类BASIS_POINTS以基点百分比表示100 个基点 1%TICKS以最小价格变动单位tick数量表示PRICE_TIERvenue 特定的价格档位。注意文档同时指出TrailingOffsetType缺失None对追踪订单而言是非法的必须在创建时显式提供。源码级解析触发价与限价如何随市场更新理解 Trailing-Stop-Limit 的行为最直接的方式是阅读它的核心计算逻辑。crates/execution/src/trailing.rs中的trailing_stop_calculate函数负责在每次市场更新时为追踪止损单计算新的触发价与限价trailing.rs其关键语义如下只朝有利方向移动单向收紧maybe_move闭包通过better_trigger比较候选价与当前价——OrderSide::Buy时c p才算更优OrderSide::Sell时c p才算更优。候选价若未改善则保持原价不动。也就是说买入追踪止损的触发价只会下移卖出追踪止损的触发价只会上移绝不可能反向放松。偏移量的换算compute闭包Price直接使用偏移量数值BasisPointsbasis * offset / 10_000100 基点 1%Ticksoffset * price_increment以 instrument 的price_increment为 tick 大小其他类型如PriceTier当前计算路径会直接报错。买卖方向的价格基点买入订单以ask卖价为基点并加上偏移得到触发价/限价basis offset卖出订单以bid买价为基点并减去偏移basis - offset。这与文档示例以距当前 ask 0.00100 USD 的偏移追踪买入单完全吻合。触发方法决定市场数据源LastPrice/MarkPrice以最新成交价或标记价为基点Default/BidAsk/LastOrBidAsk买入以 ask、卖出以 bid 为基点Default在本地表现为BidAsk报价行为见 trailing.rs 及测试注释DoubleLast、DoubleBidAsk、IndexPrice等类型当前不被该计算路径支持。触发价缺失时自动物化trigger_price以当前订单携带的触发价为种子只种触发价、绝不使用激活价若触发价尚未物化None首次更新的候选价会直接成为初始触发价——这正是工厂示例中把trigger_price传None的原因文档注释materializes from the offset on the first trail。Trailing-Stop-Limit 专属当订单类型为TrailingStopLimit时函数还会用limit_offset计算候选限价与触发价使用同一市场基点并通过better_limit单向收紧。trailing_stop_calculate返回(new_trigger_price, new_limit_price)二元组None表示对应价格未改善。计算函数在两个执行路径中的调用同一套计算函数被两处核心组件复用见 crates/execution/src 目录模拟撮合引擎crates/execution/src/matching_engine/mod.rs的update_trailing_stop_ordermod.rs每次市场数据更新时用price_increment、订单当前触发价、bid/ask/last调用trailing_stop_calculate若市场数据尚不齐备导致计算失败则记录 debug 日志并等待下一次更新若两个价格均未改善则直接返回否则通过generate_order_updated生成OrderUpdated事件把新触发价/限价应用到订单上。这解释了文档所说限价价格也随市场更新直到触发的落地方式。本地订单模拟器crates/execution/src/order_emulator/emulator.rsemulator.rs 附近对设置了emulation_trigger的追踪止损单同样调用trailing_stop_calculate更新本地触发价并在触发条件满足时将其转换为LIMIT订单释放。TrailingStopLimitOrder 订单模型与校验规则订单类型的底层模型定义于 crates/model/src/orders/trailing_stop_limit.rsTrailingStopLimitOrder结构体包含以下专属字段activation_price: OptionPrice——激活价price: OptionPrice——当前限价触发前随市场更新trigger_price: OptionPrice——当前触发价trigger_type: TriggerType——触发方法limit_offset: Decimal、trailing_offset: Decimal、trailing_offset_type: TrailingOffsetType——两组偏移量及其类型expire_time、is_post_only、display_qty、trigger_instrument_id——通用执行指令is_activated: bool、is_triggered: bool、ts_triggered: OptionUnixNanos——激活/触发状态及触发时间戳。new_checkedtrailing_stop_limit.rs定义了创建时的完整校验规则这些规则同样被 Python 与 Rust 工厂路径共用quantity必须为正数否则报invalidQuantityfor quantity not positivedisplay_qty若提供不得超过quantitytime_in_force为GTD时expire_time必填且不能为零订单元数据必须通过OrderInitialized::new_checked的全部不变量。这些约束都有对应的单元测试佐证同文件mod tests一节如test_quantity_zero_err、test_display_qty_gt_quantity_err、test_gtd_without_expire_err。此外TryFromOrderInitialized实现要求trigger_type、limit_offset、trailing_offset、trailing_offset_type四项在初始化事件中必须存在否则视为谓词违反错误——说明这四项对 Trailing-Stop-Limit 而言是强制字段。值得注意的两个行为细节限价延迟物化has_price()的实现trailing_stop_limit.rs注释明确说明限价在首次追踪更新从limit_offset物化之前可能为None因此依赖 own-book / 价格的路径必须用has_price()判断而非假定限价存在。测试test_has_price_false_until_limit_materializes验证了这一点。更新事件应用update方法trailing_stop_limit.rs在收到OrderUpdated时同步更新price、trigger_price、quantity与leaves_qtyapply方法在收到Triggered事件时置位is_triggered并记录ts_triggered。订单状态机中的位置TRIGGERED状态在订单生命周期中专门覆盖stop-limit、trailing-stop-limit 或 limit-if-touched 订单在 venue 上被触发这一情形见 orders/index.md 的 Order status definitions 表。触发后订单进入TRIGGERED随后由释放出的限价单继续走ACCEPTED → PARTIALLY_FILLED → FILLED或CANCELED/EXPIRED等常规状态流。实战建议与风险提示结合官方文档与源码实现使用 Trailing-Stop-Limit 时有几点值得注意与 Stop-Limit 共享的滑点与不成交风险触发后释放的是限价单快速反转行情下可能挂在盘口无法成交仓位继续保持开放。若必须离场优先于价格保护请改用 Trailing-Stop-Market。reduce_onlyTrue是常见的组合用法示例中即为reduce_only置真配合SimulatedExchange的行为仓位归零时自动撤单、按剩余仓位缩减数量可用于实现只减仓的动态保护逻辑。触发方法与偏移类型的搭配要符合 venue 能力不同 adapter/venue 对条件订单的支持程度不同adapter 可能在提交前拒绝不支持的请求或由 venue 直接拒单见 orders/index.md 的说明。本地模拟路径目前只接受DEFAULT/BID_ASK/LAST_PRICE作为emulation_trigger见 emulated.md。触发价/限价可由偏移自动物化不必同时提供price、trigger_price与两个偏移量省略价格、只给偏移让首次追踪更新自动生成价格是文档示例推荐的简洁写法。追踪只收紧不回退无论行情如何反复触发价与限价都只会朝有利方向单向移动这既是特性也是约束——用它做移动止损保护而不是灵活调整出场价。相关指南Orders 总览订单概念、执行指令、TrailingOffsetType/TriggerType 枚举与 FIX OrdType 映射Emulated orders在无原生支持的 venue 上本地模拟追踪止损Execution 概念订单如何到达 venue、成交如何处理Stop-Limit 指南与本文订单共享限价触发后可能不成交的风险模型Trailing-Stop-Market 指南释放市价单的追踪止损变体。延伸阅读仓库中的关键实现位置订单模型与校验crates/model/src/orders/trailing_stop_limit.rs触发/限价计算算法crates/execution/src/trailing.rs模拟撮合引擎中的追踪更新crates/execution/src/matching_engine/mod.rs本地模拟器调用crates/execution/src/order_emulator/emulator.rsRust 工厂实现crates/common/src/factories/order.rsPython 类型桩python/nautilus_trader/common/init.pyi【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考