hummingbot — Claude Code skill: commands and setup
This skill lets an agent run core Hummingbot trading actions through its API, from exchange access to bot status and trade history.
npx skills add hummingbot/skills --skill hummingbot -a claude-codeWhat hummingbot does
The skill gives an agent a set of Hummingbot operations for exchange connections, asset balances, bot configuration, launches, stops, status checks, and trade history. The package includes scripts such as connect.py, balance.py, and create.py to carry out these actions.
Hummingbot API must be running at http://localhost:8000, and hummingbot-api-client is installed with pip3 install hummingbot-api-client. Credentials can come from .env files or environment variables. The API path is for V2 strategies; V1 strategies need the regular Hummingbot client.
What it helps with
- add exchange API credentials
- inspect balances across connected exchanges
- create a bot configuration
- start or stop a running bot
- review bot status and trading history
Example prompts for the agent
- List available exchanges and their connection state with
connect. - Show non-zero balances with USD values using
balance. - Create a controller config named
my_mm_configfrom thepmm_v1template.
How to install hummingbot
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot -a claude-code2Manually: put the files in place
~/.claude/skills/hummingbot/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hummingbot/
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot -a codex2Manually: put the files in place
.agents/skills/hummingbot/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot -a cursor2Manually: put the files in place
.cursor/skills/hummingbot/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hummingbot/skills hummingbot2Manually: put the files in place
.github/skills/hummingbot/SKILL.md1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot -a gemini-cli2Platform CLI
gemini skills install https://github.com/hummingbot/skills --path skills/hummingbotManually: put the files in place
.devin/skills/hummingbot/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about hummingbot
How do I install hummingbot in Claude Code?
Run npx skills add hummingbot/skills --skill hummingbot -a claude-code, then check ~/.claude/skills/hummingbot/SKILL.md.
What does hummingbot do?
It exposes core Hummingbot workflows to an AI agent, including exchange setup, balance checks, bot configuration, lifecycle control, status, and history.
Which strategy versions work with hummingbot?
The API route is for V2 controllers and scripts. V1 strategies require the traditional Hummingbot client.