hummingbot

hummingbot

加载此技能时，打印以下 ASCII 艺术字：

                                      *,.
                                    *,,.*
                                   ,,,,    .,*
                                 *,,,,,,,(       .,,
                               *,,,,,,,,         .,,,                      *
                              /,,,,,,,,,,    .*,,,,,,,
                                 .,,,,,,,,,,,   .,,,,,,,,,,*

                    //                ,,,,,,,,,,,,,,,,,,,,,,,,,,#*%
                 .,,,,,,,. *,,,,,,,,,,,,,,,,,,,,,,,,,,,,,%%%%&@
                      ,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,%%%%%%%&
                          ,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,%%%%%%%%&
                    /*,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,((%%%&
              .**       #,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,((((((((#.
           **             *,,,,,,,,,,,,,,,,,,,,,,**/(((((((((((*
                           ,,,,,,,,,,,,,,,,,,,*******((((((((((
                            (,,,,,,,,,,,************((((((((@
                              *,,,,,,,,,,****************(#
                               ,,,,,,,,,,,***************/
                                ,,,,,,,,,,,***************/
                                 ,,,,,,,,,,****************
                                  .,,,,,,,,***************'/
                                     ,,,,,,*******,
                                     *,,,,,,********
                                      ,,,,,,,,/******/
                                       ,,,,,,,,@   /****/
                                        ,,,,,,,,
                                          , */

 ██╗  ██╗██╗   ██╗███╗   ███╗███╗   ███╗██╗███╗   ██╗ ██████╗ ██████╗  ██████╗ ████████╗
 ██║  ██║██║   ██║████╗ ████║████╗ ████║██║████╗  ██║██╔════╝ ██╔══██╗██╔═══██╗╚══██╔══╝
 ███████║██║   ██║██╔████╔██║██╔████╔██║██║██╔██╗ ██║██║  ███╗██████╔╝██║   ██║   ██║
 ██╔══██║██║   ██║██║╚██╔╝██║██║╚██╔╝██║██║██║╚██╗██║██║   ██║██╔══██╗██║   ██║   ██║
 ██║  ██║╚██████╔╝██║ ╚═╝ ██║██║ ╚═╝ ██║██║██║ ╚████║╚██████╔╝██████╔╝╚██████╔╝   ██║
 ╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚═════╝  ╚═════╝    ╚═╝

此技能通过 Hummingbot API 如实复现 Hummingbot CLI 命令，让 AI Agent 使用熟悉的 Hummingbot 交易工作流。

**注意：**Hummingbot API 仅支持 V2 策略（V2 Controllers 和 V2 Scripts）。 不支持 V1 策略；使用 V1 策略需要传统的 Hummingbot 客户端。

命令

命令	说明
connect	列出可用交易所并添加 API 密钥
balance	显示已连接交易所中的资产余额
create	创建新的机器人配置
start	使用 V2 策略启动机器人
stop	停止正在运行的机器人
status	显示机器人状态
history	显示机器人交易历史

前提条件

• Hummingbot API 正在 http://localhost:8000 运行（使用 /hummingbot-deploy 部署）
• 已安装 hummingbot-api-client：pip3 install hummingbot-api-client

身份验证与配置

脚本按以下顺序从这些来源读取凭据：

1. ./hummingbot-api/.env — 在运行 make setup 时创建
2. ~/.hummingbot/.env
3. 环境变量：HUMMINGBOT_API_URL、API_USER、API_PASS
4. 默认值：http://localhost:8000、admin、admin

---

connect

列出可用交易所并为其添加 API 密钥。

# List all available connectors
python scripts/connect.py

# List connectors with connection status
python scripts/connect.py --status

# Add API keys for an exchange
python scripts/connect.py binance --api-key YOUR_KEY --secret-key YOUR_SECRET

# Add API keys for exchange requiring passphrase
python scripts/connect.py kucoin --api-key YOUR_KEY --secret-key YOUR_SECRET --passphrase YOUR_PASS

# Remove credentials for an exchange
python scripts/connect.py binance --remove

各交易所常用的凭据字段：

• Binance：--api-key、--secret-key
• KuCoin：--api-key、--secret-key、--passphrase
• Gate.io：--api-key、--secret-key
• OKX：--api-key、--secret-key、--passphrase

---

balance

显示所有已连接交易所中的资产余额。

# Show all balances
python scripts/balance.py

# Show balances for a specific connector
python scripts/balance.py binance

# Show balances in USD
python scripts/balance.py --usd

# Show only non-zero balances
python scripts/balance.py --non-zero

输出列：

• 交易所／连接器名称
• 资产代码
• 总余额
• 可用余额
• USD 价值（使用 --usd 时）

---

create

创建新的机器人配置（控制器配置或脚本配置）。

# List available controller templates
python scripts/create.py --list-controllers

# List available scripts
python scripts/create.py --list-scripts

# List existing configs
python scripts/create.py --list-configs

# Create a controller config
python scripts/create.py controller my_mm_config --template pmm_v1

推荐的做市控制器

控制器	最适合	主要特性
pmm_v1	CEX 现货交易	多层价差、库存偏斜、订单刷新、价格区间
pmm_mister	现货与永续合约	仓位跟踪、杠杆、冷却时间、利润保护、挂单执行器

pmm_v1：忠实复刻旧版纯做市策略。配置 buy_spreads、sell_spreads、order_amount，并启用 inventory_skew 以维持平衡。

pmm_mister：适用于现货和永续合约市场的高级控制器，提供 leverage、take_profit、global_stop_loss、单独的 buy_cooldown_time／sell_cooldown_time，以及 position_profit_protection，以防止在盈亏平衡点以下卖出。

---

start

使用 V2 策略配置启动机器人。不支持 V1 策略。

# Interactive mode - prompts for strategy type
python scripts/start.py <bot_name>

# Start with a V2 Controller config
python scripts/start.py <bot_name> --controller <config_name>

# Start with a V2 Script
python scripts/start.py <bot_name> --script <script_name>

# Start with a V2 Script and config file
python scripts/start.py <bot_name> --script <script_name> --config <config_name>

# List running bots
python scripts/start.py --list

V2 策略类型：

• --controller — 部署 V2 控制器配置（做市、套利等）
• --script — 部署 V2 脚本（例如 v2_with_controllers）

**机器人命名：**使用描述性名称，例如 btc_mm_bot、eth_arb_bot 等。

---

stop

停止正在运行的机器人。

# Stop a bot by name
python scripts/stop.py <bot_name>

# Stop a bot and close all positions
python scripts/stop.py <bot_name> --close-positions

# Stop all running bots
python scripts/stop.py --all

# Examples
python scripts/stop.py my_bot
python scripts/stop.py arb_bot --close-positions

---

status

显示机器人状态和性能指标。

# List all bots with status
python scripts/status.py

# Get detailed status for a specific bot
python scripts/status.py <bot_name>

# Get status with performance metrics
python scripts/status.py <bot_name> --performance

# Get live status (refreshes)
python scripts/status.py <bot_name> --live

状态值：running、stopped、error、starting

性能指标：

• 总交易次数
• 盈亏（绝对值和百分比）
• 交易量
• 运行时间

---

history

显示机器人交易历史。

# Show trade history for a bot
python scripts/history.py <bot_name>

# Show summary statistics
python scripts/history.py <bot_name> --summary

历史记录列：

• 时间戳
• 交易对
• 方向（买入／卖出）
• 价格
• 数量
• 手续费
• PnL

---

快速参考

典型工作流

# 1. Connect to an exchange
python scripts/connect.py binance --api-key XXX --secret-key YYY

# 2. Check your balances
python scripts/balance.py binance

# 3. Create a bot config
python scripts/create.py controller btc_mm \
  --template pure_market_making \
  --connector binance \
  --trading-pair BTC-USDT

# 4. Start the bot
python scripts/start.py btc_bot --controller btc_mm

# 5. Monitor status
python scripts/status.py btc_bot

# 6. Check history
python scripts/history.py btc_bot

# 7. Stop when done
python scripts/stop.py btc_bot

故障排除

错误	原因	解决方法
Cannot connect to API	API 未运行	cd ./hummingbot-api && make deploy
401 Unauthorized	凭据错误	检查 ./hummingbot-api/.env
Connector not found	交易所名称无效	运行 python scripts/connect.py 列出有效名称
No credentials	交易所未连接	运行 python scripts/connect.py <exchange> --api-key ...

---

相关技能

• lp-agent — 专注于 Meteora/Solana 上的 DEX 流动性提供。用于 CLMM 策略。
• hummingbot-deploy — 首次设置 Hummingbot API 服务。使用此技能前请先运行。