# hummingbot-heartbeat

Gathers hourly Hummingbot status metrics and portfolio balances for automated chat alerts. Useful for tracking trading controllers and active executors remotely.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 355 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-heartbeat/SKILL.md
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/skills/hummingbot-heartbeat

## What it does

The skill runs `scripts/bot_status.py` to inspect a local Hummingbot deployment. It queries endpoints for the API version, active bot controllers, open trade executors, and recent portfolio valuations. When Docker is present on the machine, the script also checks the status of the Gateway container using `docker ps`.

Configuration values come from environment variables or a local `.env` file. By default, the script connects to `http://localhost:8000` with standard `admin` credentials.

Without an accessible Hummingbot API instance, the script fails immediately upon execution. The host environment requires Python 3.9 or higher.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill hummingbot-heartbeat -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-heartbeat/SKILL.md

## When to use it
- Track Hummingbot API health and version updates automatically
- Inspect active bot controllers without terminal access
- Filter out terminated or failed trade executors to monitor active runs
- Report token balances and total portfolio value directly to chat

## Example prompts
- Set up the hummingbot-heartbeat cron task for hourly notifications
- Run `python3 scripts/bot_status.py` to check the current bot status
- Execute `python3 scripts/bot_status.py --json` to generate raw JSON metrics

## Similar
- [churn-prevention](https://affpapa.org/en/nevibecode/skills/coreyhaines31-churn-prevention.md) — skill · 121600 installs
- [revops](https://affpapa.org/en/nevibecode/skills/revops.md) — skill · 114000 installs
- [ads](https://affpapa.org/en/nevibecode/skills/ads.md) — skill · 83400 installs
- [pricing](https://affpapa.org/en/nevibecode/skills/pricing.md) — skill · 79900 installs
- [marketing-plan](https://affpapa.org/en/nevibecode/skills/marketing-plan.md) — skill · 68400 installs
- [humanizer](https://affpapa.org/en/nevibecode/skills/blader-humanizer.md) — skill · 10600 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