技能名称：hummingbot

详细描述：

hummingbot

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

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

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

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

该技能通过 Hummingbot API 忠实复现 Hummingbot CLI 命令，将您熟悉的 Hummingbot 交易工作流引入 AI 代理。

注意： Hummingbot API 仅支持 V2 策略（V2 控制器和 V2 脚本）。
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. 1. ./hummingbot-api/.env — 在 make setup 期间创建
2. ~/.hummingbot/.env
3. 环境变量：HUMMINGBOTAPIURL、APIUSER、APIPASS
4. 默认值：http://localhost:8000、admin、admin

---

connect

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

bash

列出所有可用连接器

python scripts/connect.py

列出连接器及其连接状态

python scripts/connect.py --status

为交易所添加 API 密钥

python scripts/connect.py binance --api-key YOURKEY --secret-key YOURSECRET

为需要密码短语的交易所添加 API 密钥

python scripts/connect.py kucoin --api-key YOURKEY --secret-key YOURSECRET --passphrase YOUR_PASS

移除交易所的凭据

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

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

bash

显示所有余额

python scripts/balance.py

显示特定连接器的余额

python scripts/balance.py binance

以美元显示余额

python scripts/balance.py --usd

仅显示非零余额

python scripts/balance.py --non-zero

输出列：

• - 交易所/连接器名称
• 资产符号
• 总余额
• 可用余额
• 美元价值（使用 --usd 时）

---

create

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

bash

列出可用控制器模板

python scripts/create.py --list-controllers

列出可用脚本

python scripts/create.py --list-scripts

列出现有配置

python scripts/create.py --list-configs

创建控制器配置

python scripts/create.py controller mymmconfig --template pmm_v1

推荐的做市控制器

控制器	最适合	主要特性
pmmv1	CEX 现货交易	多层价差、库存倾斜、订单刷新、价格区间
pmmmister

现货与永续合约 | 仓位跟踪、杠杆、冷却时间、利润保护、挂单执行器 |

pmmv1：忠实克隆传统纯做市策略。配置 buyspreads、sellspreads、orderamount，并启用 inventory_skew 以维持平衡。

pmmmister：适用于现货和永续市场的高级控制器，具有 leverage、takeprofit、globalstoploss、独立的 buycooldowntime/sellcooldowntime，以及 positionprofitprotection 以防止低于盈亏平衡点卖出。

---

start

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

bash

交互模式 - 提示选择策略类型

python scripts/start.py

使用 V2 控制器配置启动

python scripts/start.py name> --controller name>

使用 V2 脚本启动

python scripts/start.py name> --script name>

使用 V2 脚本和配置文件启动

python scripts/start.py name> --script name> --config

列出正在运行的机器人

python scripts/start.py --list

V2 策略类型：

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

机器人命名： 使用描述性名称，如 btcmmbot、etharbbot 等。