NautilusTrader 示例体系全解析从回测脚本到 Live 适配器测试器的目录结构、运行方式与源码实践【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader本文以仓库 examples/README.md 为核心骨架系统梳理 NautilusTrader 示例脚本的组织方式、环境上下文划分Backtest / Live / Other、Rust-native 适配器测试器data_tester.py/exec_tester.py的定位与运行方法并结合examples/目录下的真实脚本与nautilus_trader.testkit中的内置测试器配置逐层拆解每个示例的组成要素与可复现的运行流程。读完本文你将掌握如何从仓库根目录用一条命令在 testnet 上跑通数据流/执行流测试器如何理解并改造回测脚本以及如何借助内置 DataTester / ExecTester 快速验证任意适配器。一、示例体系的整体布局NautilusTrader 的示例代码全部集中在仓库根目录的examples/下按照**系统环境上下文system environment context**分为三大类这是理解整个目录的第一把钥匙分类环境语义覆盖内容Backtest历史数据 模拟交易场所simulated venues在BacktestEngine中回放行情、运行策略、输出账户/成交/持仓报告Live真实、sandbox 与 testnet 场所基于LiveNode构建的实时行情订阅、下单执行、适配器连通性测试Other策略之外的各种示例如最小可复现 Bug 模板minimal reproducible example等在每个环境目录内部脚本进一步按集成integration组织即按交易所/数据源适配器划分。例如examples/live/下可以看到architect_ax/、betfair/、binance/、bitmex/、blockchain/、bybit/、coinbase/、databento/、deribit/、derive/、dydx/、hyperliquid/、interactive_brokers/、kraken/、lighter/、okx/、polymarket/、sandbox/、tardis/等众多适配器子目录而examples/backtest/下的脚本则按策略/数据主题平铺如 EMA 交叉、订单簿失衡、强平演示、期权链等。这种环境上下文 → 适配器集成的两级组织方式使得无论你是想验证某个交易所的连通性还是想参考某种策略在回测中的写法都能在固定位置快速找到对应脚本。二、Live 适配器测试器data_tester.py与exec_tester.py2.1 统一命名与维护策略原文档强调了一个重要的命名约定受维护的 Rust-native 适配器测试器统一使用通用文件名data_tester.py与exec_tester.py位于live/adapter/目录下取代了历史上带适配器前缀的测试器变体如lighter_data_tester.py。这意味着无论哪个适配器其数据测试脚本都叫data_tester.py、执行测试脚本都叫exec_tester.py便于自动化工具和文档统一引用。从实际目录看这一约定已全面落地数据测试器data_tester.py覆盖architect_ax/、betfair/、binance/、blockchain/、bybit/、coinbase/、databento/、deribit/、derive/、dydx/、hyperliquid/、interactive_brokers/、kraken/、lighter/、okx/、polymarket/、tardis/执行测试器exec_tester.py覆盖architect_ax/、betfair/、binance/、bybit/、deribit/、derive/、dydx/、hyperliquid/、interactive_brokers/、kraken/、lighter/、okx/、polymarket/此外受维护的sandbox 执行测试器为live/sandbox/exec_tester.py用于在本地模拟撮合引擎上验证执行链路。2.2 示例的统一技术底座原文档指出所有被跟踪tracked的 Python 示例都只引用当前公开的包表面public package surface。适配器示例依赖三样东西nautilus_trader.live.LiveNode—— 实时交易节点的构建入口nautilus_trader.testkit中的内置测试器配置DataTesterConfig/ExecTesterConfig随示例一起维护的自包含 Actor / Strategy如live/architect_ax/strategies.py中的OrderBookImbalance等。以 examples/live/lighter/data_tester.py 为例其依赖链清晰印证了这一点from nautilus_trader.adapters.lighter import LighterDataClientConfig from nautilus_trader.adapters.lighter import LighterDataClientFactory from nautilus_trader.common import Environment from nautilus_trader.live import LiveNode from nautilus_trader.testkit import DataTesterConfig2.3 前置条件包安装在运行任何示例之前必须确保nautilus_trader包可用二选一从源码编译本仓库即 Rust-native 引擎Python 绑定由python/下的 maturin 工程构建通过 pip 安装详见 docs/getting_started/installation.md注意原文档链接指向外部站点的安装指南本文以仓库内 python/README.md 作为本地参考。仓库的 Python 工程配置位于 python/pyproject.toml依赖锁定文件为 python/uv.lock示例脚本依赖的测试工具包TestDataProvider、TestInstrumentProvider、DataTester、ExecTester等来自nautilus_trader.testkit。2.4 一条命令跑通 testnet 数据流原文档给出了最直接的运行示例——从仓库根目录用uv以python/为工程环境--no-sync表示不重新同步依赖直接执行 Lighter 适配器的数据测试器uv run --project python --no-sync python examples/live/lighter/data_tester.py脚本会立即连接配置的 Lighter 环境并持续订阅市场数据流按CtrlC即可停止。默认目标环境是Lighter Testnet因此无需真实资金。从 examples/live/lighter/data_tester.py 的模块级常量可以看到可调项常量取值示例含义LIGHTER_ENVIRONMENTLighterEnvironment.TESTNET目标环境Testnet / MainnetLIGHTER_DEPLOYMENTLighterDeployment.LIGHTER部署类型Lighter 或 RobinhoodVENUELIGHTER/LIGHTER_ROBINHOOD根据部署类型自动选择的场所标识TRADER_IDTESTER-001交易者 IDINSTRUMENT_IDBTC-PERP.LIGHTER被测合约BAR_TYPEBTC-PERP.LIGHTER-1-MINUTE-LAST-EXTERNAL订阅的 K 线类型测试器主体通过LiveNode.builder(...)链式构建add_data_client挂载 Lighter 数据客户端工厂 配置随后add_builtin_actor(DataTester, DataTesterConfig(...))注入内置测试 Actor。默认配置会订阅单个合约的完整数据矩阵——book deltas、quotes、trades、bars、mark price、index price、funding rates——并同时发起 instrument、trades、bars、book snapshot、funding rates 等历史请求且全程不下任何订单log_dataTrue会把接收到的数据打到日志。三、深入 DataTester 与 ExecTester 内置测试器nautilus_trader.testkit是示例体系的测试工具箱其中两个内置测试器承担了适配器验证的核心职责其完整配置参数定义在 python/nautilus_trader/testkit/init.pyi。3.1DataTesterConfig数据面全量体检DataTesterConfig第 16 行起控制内置 DataTester Actor 的行为参数按功能分组订阅开关subscribe 系列subscribe_book_deltas、subscribe_book_depth、subscribe_book_at_interval、subscribe_quotes、subscribe_trades、subscribe_mark_prices、subscribe_index_prices、subscribe_funding_rates、subscribe_bars、subscribe_instrument、subscribe_instrument_status、subscribe_instrument_close、subscribe_option_greeks、can_unsubscribe。历史请求开关request 系列request_instruments、request_quotes、request_trades、request_bars、request_book_snapshot、request_book_deltas、request_funding_rates。簿/统计/日志控制book_depth订阅深度、book_interval_ms、book_levels_to_print、manage_book是否在本地维护订单簿、log_data、stats_interval_secs、log_events、log_commands。以 Lighter 数据测试器为例它几乎把订阅/请求开关全部打开配合manage_bookTrue可在本地重建 L2 订单簿是检验一个适配器数据面是否完整的最快路径。3.2ExecTesterConfig执行面闭环验证ExecTesterConfig第 121 行起控制内置 ExecTester 策略覆盖下单执行全流程的参数身份与订单属性strategy_id、order_id_tag、use_hyphens_in_client_order_ids、use_uuid_client_order_ids、external_order_instrument_ids、instrument_id、client_id、order_qty、order_display_qty、order_expire_time_delta_mins、order_params。行情订阅subscribe_book、subscribe_quotes、subscribe_trades以及簿参数book_type、book_depth、book_interval_ms、book_levels_to_print。开仓行为open_position_on_start_qty启动即开仓数量、open_position_on_first_quote收到首个 quote 即开仓、open_position_time_in_force默认 IOC。双边做市与止损enable_limit_buys/enable_limit_sells是否维护买/卖两侧 post-only 限价单、tob_offset_ticks相对最优买卖价的挂单偏移 tick 数、limit_time_in_force止损侧还有enable_stop_buys/enable_stop_sells、stop_order_type、stop_offset_ticks、stop_limit_offset_ticks、stop_trigger_type、stop_time_in_force。收尾与安全cancel_orders_on_stop、close_positions_on_stop、reduce_only_on_stop、dry_runTrue时仅连接、不下单、不发送关停指令、log_data。3.3 ExecTester 的典型行为模型以 examples/live/lighter/exec_tester.py 为例ExecTester 的行为是标准化的执行闭环启动以 IOC 市价单开仓open_position_on_start_qty与open_position_on_first_quoteTrue组合运行中在簿两侧以 post-only 限价单持续报价enable_limit_buys/enable_limit_sellsuse_post_onlyTruetob_offset_ticks500停止撤掉全部挂单并平掉全部仓位cancel_orders_on_stopTrue、close_positions_on_stopTrue、reduce_only_on_stopTrue。该脚本文件头部的 WARNING 明确指出DRY_RUN False时会向目标环境提交真实订单默认目标是 Lighter Testnet无真实资金风险但任何 mainnet 部署都会动用真实资金该测试策略没有任何 alpha 优势不应用于生产交易。运行前务必把DRY_RUN置为True先做连通性演练。其凭据解析遵循命名空间规则根据deployment与environment的组合从LIGHTER_*、LIGHTER_TESTNET_*、LIGHTER_ROBINHOOD_*、LIGHTER_ROBINHOOD_TESTNET_*环境变量中解析密钥。此外它还通过with_reconciliation(reconciliationTrue)与LiveExecutionEngineConfig(reconciliation_lookback_mins60, reconciliation_instrument_ids[...])启用了执行对账。3.4 Sandbox 执行测试器不碰真金白银的执行演练examples/live/sandbox/exec_tester.py 是文档点名的受维护 sandbox 执行测试器其巧妙之处在于混合数据面与执行面数据面通过BinanceDataClientFactory订阅Binance 公开行情BinanceProductType.SPOT、BinanceEnvironment.LIVE、BinanceSpotMarketDataMode.Json无需任何凭据执行面通过add_simulated_exec_client挂载SandboxExecutionClientFactory用SandboxExecutionClientConfig指定起始余额如 100,000 USDT在本地模拟撮合引擎中撮合。于是 ExecTester 在本地沙箱里对着真实 Binance 行情完成开仓、双边报价、撤单平仓的全流程不涉及任何凭据与真实资金非常适合作为执行链路冒烟测试的第一站。四、Backtest 示例从脚本结构到运行方式examples/backtest/下的脚本全部围绕BacktestEngine展开。以 examples/backtest/crypto_ema_cross_ethusdt_trade_ticks.py 为标本一个标准回测脚本通常按如下顺序组装from nautilus_trader.adapters.binance import BINANCE_VENUE from nautilus_trader.backtest import BacktestEngine from nautilus_trader.config import BacktestEngineConfig, RiskEngineConfig from nautilus_trader.model import AccountType, BarType, Currency, Money, OmsType, TraderId from nautilus_trader.testkit.providers import TestDataProvider, TestInstrumentProvider其主流程可概括为四步构建引擎BacktestEngine(BacktestEngineConfig(trader_idTraderId.from_str(BACKTESTER-001), risk_engineRiskEngineConfig(bypassTrue)))注册场所与合约add_venue(...)指定oms_type如NETTING、account_type如CASH、starting_balances如 1,000,000 USDT 10 ETH再用TestInstrumentProvider.ethusdt_binance()生成合约并add_instrument灌入历史数据TestDataProvider.trades_from_binance_csv(...)读取test_data/binance/ethusdt-trades.csvadd_data(ticks)注入引擎挂载策略并运行配置EMACrossfast_ema_period10、slow_ema_period20、trade_sizeDecimal(0.10)、BarType.from_str(ETHUSDT.BINANCE-250-TICK-LAST-INTERNAL)run()后打印账户、成交、持仓三份报告最后reset()与dispose()清理。该脚本复用了docs/tutorials/ema_cross.py中的EMACross策略通过sys.path.insert注入搜索路径体现了示例脚本 教程策略的复用模式。4.1 数据面差异tick、bar 与订单簿回放不同回测脚本的区别主要在于数据来源与簿类型Tick 级crypto_ema_cross_ethusdt_trade_ticks.py 用成交 tick 合成内部 TICK barBar 级fx_ema_cross_audusd_bars_from_ticks.py 用 TrueFX 的 quote tick 合成1-MINUTE-MID-INTERNALbar并通过FXRolloverInterestModuleInterestRateRecord数据来自test_data/short-term-interest.csv模拟 FX 隔夜利息滚转账户类型为MARGINHEDGING订单簿级crypto_orderbook_imbalance.py 用load_binance_order_book_deltas读取test_data/binance/btcusdt-depth-snap.csv与btcusdt-depth-update.csvbook_typeBookType.L2_MBP驱动订单簿失衡策略OrderBookImbalance。4.2 特殊示例强平引擎演示与最小复现模板强平演示liquidation_demo.py 对应 NautilusTrader Issue #3788展示 RustSimulatedExchange的自动保证金强平add_venue(... liquidation_enabledTrue, liquidation_trigger_ratio1.0, liquidation_cancel_open_ordersTrue)行情从 40,000 暴跌至 20,000-50%触发强平脚本支持--json参数输出结构化结果。其自定义策略MarketBuyOnStart重写了Strategy.__new__pyo3 类型的__new__只接受config这是编写 pyo3 绑定策略类时值得注意的细节。最小复现模板examples/other/minimal_reproducible_example/README.md 提供自包含 极简 易改的 Bug 上报模板内置人工数据生成无需附带市场数据文件把strategy.py与run_example.py复制出来修改即可复现问题并随 Issue 提交避免泄露私有行情数据。Notebook 示例examples/backtest/notebooks/下的脚本采用 jupytext 的py:percent格式如 databento_futures_settlement.py可直接在 Jupyter 中按 cell 运行演示 Databento BBO 样本回放与期货到期结算等主题。五、Live 场景的其他示例形态除统一的测试器外examples/live/还按适配器散落着大量策略化示例它们与测试器互补期权链/希腊值如bybit/bybit_option_chain.py、bybit/bybit_option_greeks.py、deribit/deribit_option_chain.py、okx/okx_option_greeks.py、interactive_brokers/option_greeks.py做市与报价如lighter/nvda_composite_mm.py、okx/okx_spot_swap_quoter.py自包含策略模块如architect_ax/strategies.py被examples/backtest/architect_ax_book_imbalance.py跨目录复用后者通过sys.path.insert引用IB 专项interactive_brokers/下包含connect_with_tws.py、connect_with_dockerized_gateway.py、historical_download.py、contract_download.py以及notebooks/中的括号单、OCA 组、条件单、对账等演示其他集成blockchain/提供node_test.py区块链节点连通性测试与actors.pypolymarket/updown_smoke_tester.py提供涨跌盘冒烟测试。这些脚本同样遵循模块级常量即配置、LiveNode.builder链式组装、内置测试器或随例策略驱动的统一范式。六、从读示例到改示例实操清单安装确保nautilus_trader可用源码编译或 pip 安装参考 docs/getting_started/installation.md跑通一个回测uv run --project python --no-sync python examples/backtest/crypto_ema_cross_ethusdt_trade_ticks.py确认能打印账户/成交/持仓报告跑通一个 testnet 数据流按原文档命令uv run --project python --no-sync python examples/live/lighter/data_tester.py观察行情日志后CtrlC停止试跑 sandbox 执行测试器uv run --project python --no-sync python examples/live/sandbox/exec_tester.py无需凭据即可观察本地撮合切换目标适配器把live/adapter/data_tester.py中的场所、合约、环境常量改为目标适配器对应值并确保该适配器的凭据环境变量就位安全第一任何exec_tester.py先置DRY_RUN True验证连通性确认无误再对 testnet 放开mainnet 一律视为真实资金风险。【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 NautilusTrader 示例体系全解析：从回测脚本到 Live 适配器测试器的目录结构、运行方式与源码实践
NautilusTrader 示例体系全解析从回测脚本到 Live 适配器测试器的目录结构、运行方式与源码实践【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader本文以仓库 examples/README.md 为核心骨架系统梳理 NautilusTrader 示例脚本的组织方式、环境上下文划分Backtest / Live / Other、Rust-native 适配器测试器data_tester.py/exec_tester.py的定位与运行方法并结合examples/目录下的真实脚本与nautilus_trader.testkit中的内置测试器配置逐层拆解每个示例的组成要素与可复现的运行流程。读完本文你将掌握如何从仓库根目录用一条命令在 testnet 上跑通数据流/执行流测试器如何理解并改造回测脚本以及如何借助内置 DataTester / ExecTester 快速验证任意适配器。一、示例体系的整体布局NautilusTrader 的示例代码全部集中在仓库根目录的examples/下按照**系统环境上下文system environment context**分为三大类这是理解整个目录的第一把钥匙分类环境语义覆盖内容Backtest历史数据 模拟交易场所simulated venues在BacktestEngine中回放行情、运行策略、输出账户/成交/持仓报告Live真实、sandbox 与 testnet 场所基于LiveNode构建的实时行情订阅、下单执行、适配器连通性测试Other策略之外的各种示例如最小可复现 Bug 模板minimal reproducible example等在每个环境目录内部脚本进一步按集成integration组织即按交易所/数据源适配器划分。例如examples/live/下可以看到architect_ax/、betfair/、binance/、bitmex/、blockchain/、bybit/、coinbase/、databento/、deribit/、derive/、dydx/、hyperliquid/、interactive_brokers/、kraken/、lighter/、okx/、polymarket/、sandbox/、tardis/等众多适配器子目录而examples/backtest/下的脚本则按策略/数据主题平铺如 EMA 交叉、订单簿失衡、强平演示、期权链等。这种环境上下文 → 适配器集成的两级组织方式使得无论你是想验证某个交易所的连通性还是想参考某种策略在回测中的写法都能在固定位置快速找到对应脚本。二、Live 适配器测试器data_tester.py与exec_tester.py2.1 统一命名与维护策略原文档强调了一个重要的命名约定受维护的 Rust-native 适配器测试器统一使用通用文件名data_tester.py与exec_tester.py位于live/adapter/目录下取代了历史上带适配器前缀的测试器变体如lighter_data_tester.py。这意味着无论哪个适配器其数据测试脚本都叫data_tester.py、执行测试脚本都叫exec_tester.py便于自动化工具和文档统一引用。从实际目录看这一约定已全面落地数据测试器data_tester.py覆盖architect_ax/、betfair/、binance/、blockchain/、bybit/、coinbase/、databento/、deribit/、derive/、dydx/、hyperliquid/、interactive_brokers/、kraken/、lighter/、okx/、polymarket/、tardis/执行测试器exec_tester.py覆盖architect_ax/、betfair/、binance/、bybit/、deribit/、derive/、dydx/、hyperliquid/、interactive_brokers/、kraken/、lighter/、okx/、polymarket/此外受维护的sandbox 执行测试器为live/sandbox/exec_tester.py用于在本地模拟撮合引擎上验证执行链路。2.2 示例的统一技术底座原文档指出所有被跟踪tracked的 Python 示例都只引用当前公开的包表面public package surface。适配器示例依赖三样东西nautilus_trader.live.LiveNode—— 实时交易节点的构建入口nautilus_trader.testkit中的内置测试器配置DataTesterConfig/ExecTesterConfig随示例一起维护的自包含 Actor / Strategy如live/architect_ax/strategies.py中的OrderBookImbalance等。以 examples/live/lighter/data_tester.py 为例其依赖链清晰印证了这一点from nautilus_trader.adapters.lighter import LighterDataClientConfig from nautilus_trader.adapters.lighter import LighterDataClientFactory from nautilus_trader.common import Environment from nautilus_trader.live import LiveNode from nautilus_trader.testkit import DataTesterConfig2.3 前置条件包安装在运行任何示例之前必须确保nautilus_trader包可用二选一从源码编译本仓库即 Rust-native 引擎Python 绑定由python/下的 maturin 工程构建通过 pip 安装详见 docs/getting_started/installation.md注意原文档链接指向外部站点的安装指南本文以仓库内 python/README.md 作为本地参考。仓库的 Python 工程配置位于 python/pyproject.toml依赖锁定文件为 python/uv.lock示例脚本依赖的测试工具包TestDataProvider、TestInstrumentProvider、DataTester、ExecTester等来自nautilus_trader.testkit。2.4 一条命令跑通 testnet 数据流原文档给出了最直接的运行示例——从仓库根目录用uv以python/为工程环境--no-sync表示不重新同步依赖直接执行 Lighter 适配器的数据测试器uv run --project python --no-sync python examples/live/lighter/data_tester.py脚本会立即连接配置的 Lighter 环境并持续订阅市场数据流按CtrlC即可停止。默认目标环境是Lighter Testnet因此无需真实资金。从 examples/live/lighter/data_tester.py 的模块级常量可以看到可调项常量取值示例含义LIGHTER_ENVIRONMENTLighterEnvironment.TESTNET目标环境Testnet / MainnetLIGHTER_DEPLOYMENTLighterDeployment.LIGHTER部署类型Lighter 或 RobinhoodVENUELIGHTER/LIGHTER_ROBINHOOD根据部署类型自动选择的场所标识TRADER_IDTESTER-001交易者 IDINSTRUMENT_IDBTC-PERP.LIGHTER被测合约BAR_TYPEBTC-PERP.LIGHTER-1-MINUTE-LAST-EXTERNAL订阅的 K 线类型测试器主体通过LiveNode.builder(...)链式构建add_data_client挂载 Lighter 数据客户端工厂 配置随后add_builtin_actor(DataTester, DataTesterConfig(...))注入内置测试 Actor。默认配置会订阅单个合约的完整数据矩阵——book deltas、quotes、trades、bars、mark price、index price、funding rates——并同时发起 instrument、trades、bars、book snapshot、funding rates 等历史请求且全程不下任何订单log_dataTrue会把接收到的数据打到日志。三、深入 DataTester 与 ExecTester 内置测试器nautilus_trader.testkit是示例体系的测试工具箱其中两个内置测试器承担了适配器验证的核心职责其完整配置参数定义在 python/nautilus_trader/testkit/init.pyi。3.1DataTesterConfig数据面全量体检DataTesterConfig第 16 行起控制内置 DataTester Actor 的行为参数按功能分组订阅开关subscribe 系列subscribe_book_deltas、subscribe_book_depth、subscribe_book_at_interval、subscribe_quotes、subscribe_trades、subscribe_mark_prices、subscribe_index_prices、subscribe_funding_rates、subscribe_bars、subscribe_instrument、subscribe_instrument_status、subscribe_instrument_close、subscribe_option_greeks、can_unsubscribe。历史请求开关request 系列request_instruments、request_quotes、request_trades、request_bars、request_book_snapshot、request_book_deltas、request_funding_rates。簿/统计/日志控制book_depth订阅深度、book_interval_ms、book_levels_to_print、manage_book是否在本地维护订单簿、log_data、stats_interval_secs、log_events、log_commands。以 Lighter 数据测试器为例它几乎把订阅/请求开关全部打开配合manage_bookTrue可在本地重建 L2 订单簿是检验一个适配器数据面是否完整的最快路径。3.2ExecTesterConfig执行面闭环验证ExecTesterConfig第 121 行起控制内置 ExecTester 策略覆盖下单执行全流程的参数身份与订单属性strategy_id、order_id_tag、use_hyphens_in_client_order_ids、use_uuid_client_order_ids、external_order_instrument_ids、instrument_id、client_id、order_qty、order_display_qty、order_expire_time_delta_mins、order_params。行情订阅subscribe_book、subscribe_quotes、subscribe_trades以及簿参数book_type、book_depth、book_interval_ms、book_levels_to_print。开仓行为open_position_on_start_qty启动即开仓数量、open_position_on_first_quote收到首个 quote 即开仓、open_position_time_in_force默认 IOC。双边做市与止损enable_limit_buys/enable_limit_sells是否维护买/卖两侧 post-only 限价单、tob_offset_ticks相对最优买卖价的挂单偏移 tick 数、limit_time_in_force止损侧还有enable_stop_buys/enable_stop_sells、stop_order_type、stop_offset_ticks、stop_limit_offset_ticks、stop_trigger_type、stop_time_in_force。收尾与安全cancel_orders_on_stop、close_positions_on_stop、reduce_only_on_stop、dry_runTrue时仅连接、不下单、不发送关停指令、log_data。3.3 ExecTester 的典型行为模型以 examples/live/lighter/exec_tester.py 为例ExecTester 的行为是标准化的执行闭环启动以 IOC 市价单开仓open_position_on_start_qty与open_position_on_first_quoteTrue组合运行中在簿两侧以 post-only 限价单持续报价enable_limit_buys/enable_limit_sellsuse_post_onlyTruetob_offset_ticks500停止撤掉全部挂单并平掉全部仓位cancel_orders_on_stopTrue、close_positions_on_stopTrue、reduce_only_on_stopTrue。该脚本文件头部的 WARNING 明确指出DRY_RUN False时会向目标环境提交真实订单默认目标是 Lighter Testnet无真实资金风险但任何 mainnet 部署都会动用真实资金该测试策略没有任何 alpha 优势不应用于生产交易。运行前务必把DRY_RUN置为True先做连通性演练。其凭据解析遵循命名空间规则根据deployment与environment的组合从LIGHTER_*、LIGHTER_TESTNET_*、LIGHTER_ROBINHOOD_*、LIGHTER_ROBINHOOD_TESTNET_*环境变量中解析密钥。此外它还通过with_reconciliation(reconciliationTrue)与LiveExecutionEngineConfig(reconciliation_lookback_mins60, reconciliation_instrument_ids[...])启用了执行对账。3.4 Sandbox 执行测试器不碰真金白银的执行演练examples/live/sandbox/exec_tester.py 是文档点名的受维护 sandbox 执行测试器其巧妙之处在于混合数据面与执行面数据面通过BinanceDataClientFactory订阅Binance 公开行情BinanceProductType.SPOT、BinanceEnvironment.LIVE、BinanceSpotMarketDataMode.Json无需任何凭据执行面通过add_simulated_exec_client挂载SandboxExecutionClientFactory用SandboxExecutionClientConfig指定起始余额如 100,000 USDT在本地模拟撮合引擎中撮合。于是 ExecTester 在本地沙箱里对着真实 Binance 行情完成开仓、双边报价、撤单平仓的全流程不涉及任何凭据与真实资金非常适合作为执行链路冒烟测试的第一站。四、Backtest 示例从脚本结构到运行方式examples/backtest/下的脚本全部围绕BacktestEngine展开。以 examples/backtest/crypto_ema_cross_ethusdt_trade_ticks.py 为标本一个标准回测脚本通常按如下顺序组装from nautilus_trader.adapters.binance import BINANCE_VENUE from nautilus_trader.backtest import BacktestEngine from nautilus_trader.config import BacktestEngineConfig, RiskEngineConfig from nautilus_trader.model import AccountType, BarType, Currency, Money, OmsType, TraderId from nautilus_trader.testkit.providers import TestDataProvider, TestInstrumentProvider其主流程可概括为四步构建引擎BacktestEngine(BacktestEngineConfig(trader_idTraderId.from_str(BACKTESTER-001), risk_engineRiskEngineConfig(bypassTrue)))注册场所与合约add_venue(...)指定oms_type如NETTING、account_type如CASH、starting_balances如 1,000,000 USDT 10 ETH再用TestInstrumentProvider.ethusdt_binance()生成合约并add_instrument灌入历史数据TestDataProvider.trades_from_binance_csv(...)读取test_data/binance/ethusdt-trades.csvadd_data(ticks)注入引擎挂载策略并运行配置EMACrossfast_ema_period10、slow_ema_period20、trade_sizeDecimal(0.10)、BarType.from_str(ETHUSDT.BINANCE-250-TICK-LAST-INTERNAL)run()后打印账户、成交、持仓三份报告最后reset()与dispose()清理。该脚本复用了docs/tutorials/ema_cross.py中的EMACross策略通过sys.path.insert注入搜索路径体现了示例脚本 教程策略的复用模式。4.1 数据面差异tick、bar 与订单簿回放不同回测脚本的区别主要在于数据来源与簿类型Tick 级crypto_ema_cross_ethusdt_trade_ticks.py 用成交 tick 合成内部 TICK barBar 级fx_ema_cross_audusd_bars_from_ticks.py 用 TrueFX 的 quote tick 合成1-MINUTE-MID-INTERNALbar并通过FXRolloverInterestModuleInterestRateRecord数据来自test_data/short-term-interest.csv模拟 FX 隔夜利息滚转账户类型为MARGINHEDGING订单簿级crypto_orderbook_imbalance.py 用load_binance_order_book_deltas读取test_data/binance/btcusdt-depth-snap.csv与btcusdt-depth-update.csvbook_typeBookType.L2_MBP驱动订单簿失衡策略OrderBookImbalance。4.2 特殊示例强平引擎演示与最小复现模板强平演示liquidation_demo.py 对应 NautilusTrader Issue #3788展示 RustSimulatedExchange的自动保证金强平add_venue(... liquidation_enabledTrue, liquidation_trigger_ratio1.0, liquidation_cancel_open_ordersTrue)行情从 40,000 暴跌至 20,000-50%触发强平脚本支持--json参数输出结构化结果。其自定义策略MarketBuyOnStart重写了Strategy.__new__pyo3 类型的__new__只接受config这是编写 pyo3 绑定策略类时值得注意的细节。最小复现模板examples/other/minimal_reproducible_example/README.md 提供自包含 极简 易改的 Bug 上报模板内置人工数据生成无需附带市场数据文件把strategy.py与run_example.py复制出来修改即可复现问题并随 Issue 提交避免泄露私有行情数据。Notebook 示例examples/backtest/notebooks/下的脚本采用 jupytext 的py:percent格式如 databento_futures_settlement.py可直接在 Jupyter 中按 cell 运行演示 Databento BBO 样本回放与期货到期结算等主题。五、Live 场景的其他示例形态除统一的测试器外examples/live/还按适配器散落着大量策略化示例它们与测试器互补期权链/希腊值如bybit/bybit_option_chain.py、bybit/bybit_option_greeks.py、deribit/deribit_option_chain.py、okx/okx_option_greeks.py、interactive_brokers/option_greeks.py做市与报价如lighter/nvda_composite_mm.py、okx/okx_spot_swap_quoter.py自包含策略模块如architect_ax/strategies.py被examples/backtest/architect_ax_book_imbalance.py跨目录复用后者通过sys.path.insert引用IB 专项interactive_brokers/下包含connect_with_tws.py、connect_with_dockerized_gateway.py、historical_download.py、contract_download.py以及notebooks/中的括号单、OCA 组、条件单、对账等演示其他集成blockchain/提供node_test.py区块链节点连通性测试与actors.pypolymarket/updown_smoke_tester.py提供涨跌盘冒烟测试。这些脚本同样遵循模块级常量即配置、LiveNode.builder链式组装、内置测试器或随例策略驱动的统一范式。六、从读示例到改示例实操清单安装确保nautilus_trader可用源码编译或 pip 安装参考 docs/getting_started/installation.md跑通一个回测uv run --project python --no-sync python examples/backtest/crypto_ema_cross_ethusdt_trade_ticks.py确认能打印账户/成交/持仓报告跑通一个 testnet 数据流按原文档命令uv run --project python --no-sync python examples/live/lighter/data_tester.py观察行情日志后CtrlC停止试跑 sandbox 执行测试器uv run --project python --no-sync python examples/live/sandbox/exec_tester.py无需凭据即可观察本地撮合切换目标适配器把live/adapter/data_tester.py中的场所、合约、环境常量改为目标适配器对应值并确保该适配器的凭据环境变量就位安全第一任何exec_tester.py先置DRY_RUN True验证连通性确认无误再对 testnet 放开mainnet 一律视为真实资金风险。【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考