【免费下载链接】bytex
BYTEX 命令行工具（bytex CLI）是 .NET 交易引擎 BYTEX 的统一操作入口：一条命令即可运行历史回测、启动沙箱或实盘交易节点、管理 Parquet 数据目录，还能在启动前只读验证交易所 API 密钥权限。本文面向新手，按 4 步走通 bytex CLI 的完整使用流程，几乎不用写代码。
一、bytex CLI 是什么，如何安装
BYTEX 是用 C# 编写的开源事件驱动交易引擎：策略只写一次，就能在回测、沙箱、实盘三种环境中原样运行。bytex命令行工具把这些能力封装成一条条命令，核心特点：
- 配置驱动：策略通过类型名引用、从插件程序集加载，换一份 JSON 配置即可跑不同策略，无需改代码
- 命令家族完整：
backtest、run、catalog、documents四大命令族，外加verify-keys、venues等辅助命令 - 跨平台：基于 .NET 10，支持 Linux、macOS、Windows（x64 与 ARM64）
一键安装步骤
dotnet tool install --global Bytex.Cli bytex --help也可以从源码构建后使用：
git clone https://gitcode.com/gh_mirrors/byt/bytex cd bytex dotnet build常用命令速查：
| 命令 | 用途 |
|---|---|
bytex backtest --config <文件> | 运行单次回测、批量回测或参数搜索 |
bytex run --config <文件> | 启动实盘或沙箱交易节点 |
bytex catalog ... | 管理 Parquet 数据目录（拉取、导入、列出） |
bytex documents ... | 导出、校验、查询策略文档 |
bytex verify-keys | 启动前只读检查交易所 API 密钥权限 |
bytex venues | 查看内置交易所的能力清单 |
bytex version | 打印引擎版本 |
完整 CLI 文档见 docs/getting-started/cli.md。
二、数据目录管理：用bytex catalog备好行情数据
回测需要历史行情和品种定义，BYTEX 用本地Parquet 数据目录统一管理，CLI 提供四个子命令。
从交易所拉取品种定义
bytex catalog fetch-instruments --path ./catalog --venue BINANCE --quote USDT--venue支持BINANCE、BYBIT、KUCOIN；加--futures拉取永续/期货品种，--quote USDT只拉 USDT 计价的品种。也可以改用add-instrument从单个 JSON 定义文件导入一个品种。
导入历史行情 CSV
bytex catalog import-csv --path ./catalog --file btcusdt-1m.csv --kind bars \ --instrument BTCUSDT.BINANCE \ --bar-type BTCUSDT.BINANCE-1-MINUTE-LAST-EXTERNAL \ --timestamp-format unix_ms--kind支持bars、quotes、trades三种数据；--timestamp-format可选iso、unix_s、unix_ms、unix_us、unix_ns等。完成后用bytex catalog list --path ./catalog查看全部品种、数据范围与文件大小。目录实现见 ParquetDataCatalog.cs。
三、一条命令跑回测：bytex backtest
运行单次回测
bytex --plugins ./plugins backtest --config examples/configs/backtest-ema-cross.json一份 JSON 就描述完整回测：交易所与初始资金、数据来源、策略与参数、输出目录。内置示例是 EMA（双指数移动平均）交叉策略，配置文件见 backtest-ema-cross.json，策略部分只需几个 payload 参数：
"payload": { "strategyId": "EmaCross-001", "instrumentId": "BTCUSDT.SIM", "fastPeriod": 10, "slowPeriod": 30, "tradeSize": 0.5 }运行结束打印摘要（胜率、各币种盈亏、回撤、Sharpe / Sortino 等），订单、成交、持仓与权益曲线 CSV 报告写入输出目录；--output可覆盖目录。一个配置文件里放多个回测配置（JSON 数组）时，会按顺序依次执行、各自独立出报告。
批量回测与参数搜索 🧪
- 配置中同时含
run和space字段 → 自动识别为参数搜索：用遗传算法生成候选参数组合，逐个按你指定的指标（收益率、最大回撤等）评比，最后输出最优一组。示例 search-ema-cross.json 搜索fastPeriod、slowPeriod、tradeSize三个维度 - 只含
run及变化项 →批量回测：多组运行汇总成一张对比表，适合同一策略跨品种、跨时间段比较
回测引擎细节见 docs/concepts/backtesting.md。
四、策略文档：不写代码也能跑策略 📄
BYTEX 的策略文档把策略变成数据：一张类型化的节点图（数据、指标、条件、动作、风控、流程），引擎直接运行，全程不需要 C#。CLI 提供四个子命令：
# 导出内置示例文档（ema-cross / breakout-retest / support-bounce） bytex documents examples --out ./documents # 校验文档：--catalog 附加品种与数据区间检查，--environment live 启用实盘规则 bytex documents validate --document ./documents/ema-cross.json --catalog ./catalog # 列出所有节点类型及其端口、参数 bytex documents catalog # 输出 JSON Schema，供构建器做校验 bytex documents schema回测时让配置的策略项指向文档路径即可，还能用parameterOverrides就地覆盖参数，示例配置见 backtest-document.json。文档概念详见 docs/concepts/documents.md。
五、启动交易节点：bytex run
沙箱先行：真实行情 + 模拟成交
bytex --plugins ./plugins run --config examples/configs/sandbox-binance-ema-cross.json沙箱模式流式订阅真实交易所行情，订单交给模拟交易所撮合——不需要任何 API 密钥，是实盘前的推荐第一步，配置示例见 sandbox-binance-ema-cross.json。
实盘：凭据文件 + 一条命令
bytex run --config live.json --env-file keys/bybit.env凭据放在KEY=VALUE格式的文件里（空行、#注释、export前缀均可），节点自行加载，日志只记录加载条数、永不打印键值。各交易所的环境变量名见 docs/getting-started/installation.md。按Ctrl+C时节点会按配置撤单、可选平仓后再断开；加--duration 00:02:00可定时自动停止。
远程监管：控制通道与风控参数
节点可开启本地控制通道（Windows 命名管道 / 其他系统 Unix socket，无网络监听、不携带凭据），让监控程序在不掌握密钥的情况下查看状态并下指令：
bytex run --config live.json --control my-node --halted--halted表示「暂停状态启动」：节点照常运行、订阅数据，但拒收一切新订单，等主机下发resume后才交易——这是实盘上线前的关键安全闸。通道支持status、view、cancel-all、flatten、stop、halt、resume、limits等指令，协议设计见 0009-node-control-protocol.md。
风控上限可直接在命令行覆盖配置文件（每项独立覆盖）：
| 参数 | 含义 |
|---|---|
--max-loss "1000 USDT"或2% | 周期内亏损达到该值即停止交易 |
--loss-period 1.00:00:00 | 亏损统计窗口（默认 1 天） |
--on-loss-limit stop-trading | 触达亏损上限的动作：stop-trading/deny-adds/flatten |
--max-exposure 50% | 账户最大总敞口 |
--max-open-positions 5 | 最大持仓数（可加-per-instrument限制单品种） |
--max-working-orders 50 | 最大挂单数（可加-per-instrument限制单品种） |
--display-prices会为节点持仓品种订阅实时报价，让监控端看到跳动的价格——报价仅用于展示，不会推给任何未订阅的策略。
六、启动前体检：bytex verify-keys
实盘节点启动前，先问交易所「这把密钥被允许做什么」。命令是纯只读的：不挂单、不动资金、绝不打印密钥或 secret：
bytex verify-keys --venue BYBIT --env-file keys/bybit.env bytex verify-keys --venue BINANCE --env-file keys/binance.env --json普通输出逐项汇报：密钥是否被接受、能否交易、能否出金（若「能出金」会给出警告——交易密钥不该有这权限）、是否绑定 IP、账户是否可读。检查失败时退出码为1，便于接入自动化预检；--timeout控制整体超时（默认 30 秒），--base-url可指向代理或测试环境。
七、全局参数与venues查询
| 参数 | 作用 |
|---|---|
--log-level | 日志级别：Trace/Debug/Information（默认）/Warning/Error |
--plugins | 插件程序集目录（策略、交易所适配器、指标） |
bytex venues会在不连接任何交易所的前提下，列出每个内置交易所的市场家族、密钥组成、默认费率与免费数据流；加--json得到机器可读输出。
总结：BYTEX CLI 四步工作流
- 📊备数据：
bytex catalog fetch-instruments+import-csv - 🔁验证策略：
bytex backtest --config ...（支持批量回测与参数搜索） - 🧪沙箱演练：
bytex run --config sandbox-....json - ⚡上线实盘：
verify-keys→bytex run --control --halted→ 检查状态后resume
全部示例配置位于 examples/configs/，命令实现见 Program.cs。
【免费下载链接】bytex
相关推荐
Alluxio管理员命令行工具(Admin CLI)完全指南
Alluxio管理员命令行工具 Admin CLI 完全指南 概述 Alluxio Admin CLI（管理员命令行工具）是Alluxio分布式文件系统的核心管
大数据缓存分布式文件系统存储后端数据编排解锁Nuxt 2高级功能：useMeta与SEO优化完全指南
解锁Nuxt 2高级功能：useMeta与SEO优化完全指南 在Nuxt 2开发中，利用Composition API的 useMeta 钩子可以轻松实现动态S
Celery Multi 完全指南：一条命令启动、停止与管理多个 Worker 节点
Celery Multi 完全指南：一条命令启动、停止与管理多个 Worker 节点 celery multi 是 Celery 分布式任务队列中用于从命令行启
后端任务调度消息队列
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
