开源量化利器：Passivbot 加密货币永续合约交易机器人详解

Passivbot 是一款跨平台、跨交易所的加密货币永续合约自动交易机器人。它基于 Python 与 Rust 混合开发，以“毫秒级挂单薄刷新”为核心，在 支持 Bybit、OKX、Binance、Bitget、GateIO、Hyperliquid 等交易所 的同时，主打极简运维、回测可验证与策略可调优三大亮点。下文将带你从“原理、配置、实操”三个方面快速拆解 Passivbot，让它成为你在永续合约量化路上的真正伙伴。

功能速览：Passivbot 的五张王牌

无指标仓位管理
不依赖 KDJ、MACD 等传统技术指标，而是用网格 + 马丁格尔逻辑打“市场对手盘”。
Rust 驱动回测引擎
内置 1 分钟级别历史回溯，CPU 负载由 Rust 手写模块扛，十万次回测仅需数分钟。
Evolutionary Optimizer
用进化算法在数千组参数中自寻最优解，小白也能一键“炼金”。
Forager 动态选币
实时计算各币 1 分钟蜡烛「平均波动率」，自动切仓到高波动标的，收割α收益。
Unstucking 清仓策略
对于“浮亏迟迟不回本”的仓位，分批“断指求生”，防爆仓于未然。

策略原理拆解：Passivbot 怎么“稳”?

1. 核心思路：网格·马丁的二重变奏

入场：先开小额仓位，价格越跌加仓越大，代价是把均价向市场拉近。
出场：只要反抽到微赚区间（可自定义），机器人立即平仓等下一轮。

关键词：网格加仓、均价靠拢、微小回撤即止盈。

2. Trailing Orders：让行情多走两步

Trailing Entry：待价格突破某阈值再回撤 n% 后才加仓，保证不“追高在半山腰”。
Trailing Close：盈利单回撤 n% 后才止损/止盈，锁定最大浮动利润。

关键词：回撤入场、回撤出场、滑点保护。

3. Forager —— “替你去追热点”

扫描全市场的 1min 波动率公式如下：

mean((high - low) / close)

波动率↑→机器人把火力转移到该合约；“冷门”自动筛掉，降低资金沉淀成本。

4. Unstucking：亏小钱的优雅艺术

计算所有浮亏仓位与市场价的“贴脸程度”
按近→远顺序，小亏优先减仓
账户资金永远不低于“峰值回撤百分比”，保证风险底线可控

保姆级部署教程：七步走完全程

假设你已具备 Ubuntu 22.04 / macOS / WSL 任一 Linux 环境

步骤 1：克隆源码

git clone https://github.com/enarjord/passivbot.git
cd passivbot

步骤 2：安装 Rust 编译链

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env   # 或重启终端

步骤 3：Python 虚拟环境

python3 -m venv venv
source venv/bin/activate   # Windows：.\venv\Scripts\activate

步骤 4：一键安装依赖

pip install -r requirements.txt

步骤 5：可选 Rust 加速

cd passivbot-rust
maturin develop --release
cd ..

首次启动时也会自动编译，手动执行可缩短“冷启动”时间。

步骤 6：填入 API

cp api-keys.json.example api-keys.json
# 编辑 api-keys.json，把各交易所 key 与 secret 填入

步骤 7：开跑

python3 src/main.py -u my_okx_account   # 直接跑默认模板
# 或定制配置：
python3 src/main.py configs/my_spec.json

👉 想省下本地配置麻烦？一键云端托管方案在这里

进阶玩法：自定义参数与 Jupyter Lab 联动

Passivbot 自带 Jupyter Lab 环境，回测脚本随时改、曲线秒更新：

source venv/bin/activate
jupyter lab

常见场景：

在 Notebook 中导入 backtest.py，快速对比两套加仑位点差异.
用 Optimizer 跑 5000 组参数，把夏普、最大回撤可视化导出 csv。

👉 想把自己的 Sharpe>3 配置上线？抢先试用无门槛模拟仓

FAQ：高频疑惑一次说清

Q1：Passivbot 能保盈吗？
不能！它力求“小亏即止损，多赢滚利润”，仍属高风险衍生品策略，盈亏同源，请谨慎使用。

Q2：现货能不能跑？
Passivbot 只支持永续合约；不再有 USDT 现货币对通道。

Q3：最低启动资金多少？
官方推荐 ≥ 300 USDT 保证金，杠杆 3~5x。资金越小，马丁格尔网格补充能力越弱，回撤风险越高。

Q4：Rust 模块报错怎么办？
先更新 Rust 到最新稳定版：rustup update，再重新执行 maturin develop --release。

Q5：如何防止 API 泄露？
建议采用子账户 + IP 白名单 + 只读/交易权限分离的 API key，不使用主账户密钥。

Q6：MAC M1 能跑吗？
实测 macOS 14 + M1 Pro 正常，maturin 会自动拉取 aarch64 版本，无需额外设定。

许可证 & 风险提示

Passivbot 以 无条件开放源码 形式发布，可自由复制、修改、商用。作者不对任何因使用此软件产生的盈亏及法律纠纷负责；请严格遵守所在地监管要求，并控制好杠杆与止损。

关键词总结：自动交易机器人、永续合约量化、马汀策略、Rust 回测引擎、跨交易所 API。