Hummingbot / First Run

Hummingbot首次运行:跑通第一个做市策略

装好 hbot CLI 后,用几个命令即可创建配置、跑 paper trading 模拟、连接实盘。本文按官方 README 说明核心命令。

创建:hbot create模拟:hbot start实盘:hbot connect
创建配置hbot create
hbot startpaper / live
hbot connect实盘 API keys
Hummingbot 首次运行流程示意(创建配置 → hbot start → hbot connect 实盘),基于官方 README;示意非实际运行截图。
Steps

首次运行分步流程

依据官方 README 的 hbot CLI 命令。

1. 创建 paper 配置

hbot create simple_pmm --name conf_paper_bot.yml --set exchange=binance_paper_trade --set trading_pair=BTC-USDT

2. 启动模拟

hbot start conf_paper_bot.yml,对 Binance 实时行情模拟交易,无需 API keys。

3. 查看状态

hbot status 检查运行状态;hbot stop 优雅停止。

4. 连接实盘

hbot connect binance 存 API keys(加密),再创建 strategy controller(如 pmm_mister)并 hbot start

Commands

常用 hbot CLI 命令清单

来自官方 README,完整命令见 hbot CLI guide。

命令作用
hbot create创建策略配置(paper 或实盘)
hbot start运行 bot(一个安装实例一个 bot)
hbot status查看运行状态
hbot stop优雅停止
hbot connect存储交易所 API keys(加密)
Paper vs Live

paper trading 与实盘对照

依据官方 README(2026-09 核验)。

维度paper trading实盘
API keys无需hbot connect 存加密 keys
行情Binance 实时行情模拟真实交易所行情与成交
资金风险无真实资金真实资金,存在市场与合规风险
API Keys Security

API keys 安全

hbot 用 keystore 密码加密你的交易所 API keys。

1. 首次使用设置密码

hbot 首次使用时提示输入 keystore 密码。

2. 非交互式运行

HBOT_PASSWORD 环境变量或传 --password-stdin

3. 存储加密 keys

hbot connect 加密存储交易所 API keys。

4. 保管好密码

密码用于解密 keys,丢失可能无法访问配置。

Scenario

使用场景

首次运行后,按目标进入不同路径。

验证策略

用 paper trading 对实时行情模拟,无需 API keys。

实盘做市

hbot connect 连接 API keys,用 pmm_mister 等 controller 实盘。

脚本化运维

hbot 非交互式命令,配合 --password-stdin 供脚本/agent 调用。

FAQ

常见问题

paper trading 需要 API keys 吗?

不需要。simple_pmm paper trading 脚本对 Binance 实时行情模拟交易,无 API keys 即可运行。

hbot start 报错怎么办?

先确认环境已激活、配置正确、交易所与前置条件满足;具体错误按官方 FAQ/Troubleshooting 排查。

paper 结果能直接实盘吗?

paper 结果仅代表模拟表现,实盘涉及行情延迟、滑点、费率与流动性差异,不构成收益保证。

跑通后怎么继续?

写自己的策略看策略开发页;接更多交易所看连接器页。