# hummingbot

This skill lets an agent run core Hummingbot trading actions through its API, from exchange access to bot status and trade history.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 400 installs · ★ 32
- Author: hummingbot
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hummingbot/skills/tree/HEAD/skills/hummingbot/SKILL.md
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/skills/hummingbot

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill hummingbot -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hummingbot/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hummingbot/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill hummingbot -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hummingbot/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill hummingbot -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hummingbot/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hummingbot/skills hummingbot
```

2. **Manually: put the files in place**
- File: `.github/skills/hummingbot/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill hummingbot -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hummingbot/skills --path skills/hummingbot
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hummingbot/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill hummingbot -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hummingbot/skills/tree/HEAD/skills/hummingbot/SKILL.md

## When to use it
- 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
- 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_config` from the `pmm_v1` template.

## Similar
- [okx-cex-trade](https://affpapa.org/en/nevibecode/skills/okx-cex-trade.md) — skill · 10300 installs
- [dexscreener-api](https://affpapa.org/en/nevibecode/skills/dexscreener-api.md) — skill · 463 installs
- [okx-cex-market](https://affpapa.org/en/nevibecode/skills/okx-cex-market.md) — skill · 10500 installs
- [hyperliquid](https://affpapa.org/en/nevibecode/skills/hyperliquid.md) — skill · 8700 installs
- [gmgn-wallet-analysis](https://affpapa.org/en/nevibecode/skills/gmgn-wallet-analysis.md) — skill · 6500 installs
- [crypto-regime-analyzer](https://affpapa.org/en/nevibecode/skills/crypto-regime-analyzer.md) — skill · 2700 installs

From the same set: [hummingbot/skills](https://affpapa.org/en/nevibecode/by/hummingbot/skills.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md