home / skills / 2025emma / vibe-coding-cn / hummingbot

hummingbot skill

/i18n/zh/skills/hummingbot

This skill provides comprehensive guidance for hummingbot development, features, APIs, and debugging to accelerate building automated crypto trading bots.

npx playbooks add skill 2025emma/vibe-coding-cn --skill hummingbot

Review the files below or copy the command above to add this skill to your agents.

Files (11)
SKILL.md
3.9 KB
---
name: hummingbot
description: Hummingbot trading bot framework - automated trading strategies, market making, arbitrage, connectors for crypto exchanges. Use when working with algorithmic trading, crypto trading bots, or exchange integrations.
---

# Hummingbot Skill

Comprehensive assistance with hummingbot development, generated from official documentation.

## When to Use This Skill

This skill should be triggered when:
- Working with hummingbot
- Asking about hummingbot features or APIs
- Implementing hummingbot solutions
- Debugging hummingbot code
- Learning hummingbot best practices

## Quick Reference

### Common Patterns

**Pattern 1:** For example: candles = [CandlesFactory.get_candle(connector=kucoin, trading_pair="ETH-USDT", interval="1m", max_records=100)]

```
candles = [CandlesFactory.get_candle(connector=kucoin,
           trading_pair="ETH-USDT", interval="1m", max_records=100)]
```

**Pattern 2:** Example:

```
bin/hummingbot_quickstart.py -p a -f simple_pmm_example_config.py -c conf_simple_pmm_example_config_1.yml
```

**Pattern 3:** >>> gateway swap --help usage: gateway swap [-h] [connector] [args ...] positional arguments: connector Connector name/type (e.g., jupiter/router) args Arguments: [base-quote] [side] [amount] options: -h, --help show this help message and exit

```
>>> gateway swap --help
usage: gateway swap [-h] [connector] [args ...]

positional arguments:
  connector   Connector name/type (e.g., jupiter/router)
  args        Arguments: [base-quote] [side] [amount]

options:
  -h, --help  show this help message and exit
```

**Pattern 4:** usage: gateway list [-h]

```
usage: gateway list [-h]
```

**Pattern 5:** Example:

```
price = self.market_data_provider.get_price_by_type('binance', 'BTC-USDT', PriceType.MidPrice)
```

**Pattern 6:** Example:

```
price = self.market_data_provider.get_price_by_volume('binance', 'BTC-USDT', volume: 10000, True)
```

**Pattern 7:** Example:

```
price = self.market_data_provider.get_volume_for_price('binance', 'BTC-USDT', 70000, True)
```

**Pattern 8:** Example:

```
price = self.market_data_provider.get_order_book_snapshot('binance', 'BTC-USDT')
```

## Reference Files

This skill includes comprehensive documentation in `references/`:

- **advanced.md** - Advanced documentation
- **configuration.md** - Configuration documentation
- **connectors.md** - Connectors documentation
- **development.md** - Development documentation
- **getting_started.md** - Getting Started documentation
- **other.md** - Other documentation
- **strategies.md** - Strategies documentation
- **trading.md** - Trading documentation
- **troubleshooting.md** - Troubleshooting documentation

Use `view` to read specific reference files when detailed information is needed.

## Working with This Skill

### For Beginners
Start with the getting_started or tutorials reference files for foundational concepts.

### For Specific Features
Use the appropriate category reference file (api, guides, etc.) for detailed information.

### For Code Examples
The quick reference section above contains common patterns extracted from the official docs.

## Resources

### references/
Organized documentation extracted from official sources. These files contain:
- Detailed explanations
- Code examples with language annotations
- Links to original documentation
- Table of contents for quick navigation

### scripts/
Add helper scripts here for common automation tasks.

### assets/
Add templates, boilerplate, or example projects here.

## Notes

- This skill was automatically generated from official documentation
- Reference files preserve the structure and examples from source docs
- Code examples include language detection for better syntax highlighting
- Quick reference patterns are extracted from common usage examples in the docs

## Updating

To refresh this skill with updated documentation:
1. Re-run the scraper with the same configuration
2. The skill will be rebuilt with the latest information

Overview

This skill provides practical guidance for developing, configuring, and troubleshooting Hummingbot-based trading bots. It focuses on automated trading strategies, market making, arbitrage, and exchange connector usage. It is designed to speed up implementation and debugging with common code patterns and actionable examples.

How this skill works

The skill inspects Hummingbot concepts, API patterns, and typical commands to produce clear code snippets and usage guidance. It surfaces common factory calls, market data queries, CLI examples, and connector interactions. It helps interpret errors, suggest fixes, and map development tasks to the appropriate Hummingbot components and configuration options.

When to use it

  • Implement or customize automated trading strategies (market making, arbitrage, cross-exchange).
  • Integrate or troubleshoot exchange connectors and gateway commands.
  • Retrieve market data, order book snapshots, or price calculations programmatically.
  • Configure Hummingbot instances, strategy parameters, or CLI workflows.
  • Learn Hummingbot development workflows, testing, and deployment best practices.

Best practices

  • Start with the getting_started guides and example configs to validate basic flows before customizing strategies.
  • Use market data provider helpers (get_price_by_type, get_price_by_volume) to build robust pricing logic instead of raw ticks.
  • Keep connector credentials and secrets out of committed configs; use environment variables or secure stores.
  • Test strategies in dry-run or simulation mode and use small position sizes when moving to live trading.
  • Log and capture order book snapshots and execution traces to diagnose slippage and latency issues.

Example use cases

  • Create a simple PMM (proportional market maker) strategy and run via the quickstart CLI with a predefined config file.
  • Query mid-market price and volume-based price estimates to size limit orders programmatically.
  • Implement a gateway swap flow for a new connector and validate arguments with the gateway CLI help output.
  • Capture candles or order book snapshots for backtesting a custom arbitrage strategy.
  • Debug connector authentication or rate-limit issues using connector-specific logs and troubleshooting guidance.

FAQ

Which Hummingbot components should I consult for connector issues?

Start with the connectors documentation and connector-specific logs; confirm API keys, rate limits, and network connectivity, then reproduce with the gateway CLI or a minimal script.

How do I validate a strategy before going live?

Run the strategy in simulation or dry-run mode, backtest against historical candles or order book snapshots, and use small capital on testnet or a low-risk market before scaling to production.