Guide · Agent skill
How to use the Hummingbot Trading Bot Helper agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The hummingbot skill gives an AI agent a bundle of reference notes about Hummingbot, an open-source framework for automated crypto trading bots such as market making and arbitrage. This guide explains what the skill does, how to install it, how to phrase requests so the agent uses it, and what to check before running any code it suggests. By the end you will be able to ask the agent for configuration, connector or strategy-code help and know what it can and cannot do.
Hummingbot Trading Bot Helper2025Emma/vibe-coding-cn · MIT Download the skill Quick start
- 1Download the ZIP. Download the hummingbot skill ZIP from this page.
- 2Unzip the folder. Unzip the file so you have a hummingbot folder containing SKILL.md and references/.
- 3Place the folder. Move it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder for one project.
- 4Or upload it in the apps. In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the skill.
- 5Ask a specific question. Name Hummingbot and the part you need, such as a connector, strategy or gateway command.
- 6Verify the output. Compare code examples with the official documentation before running anything.
What an agent skill is and what this one does
An agent skill is a folder of instructions and reference files that an AI agent can load when a task matches the skill's description. This one is named hummingbot and is generated from the official Hummingbot documentation.
When you ask about configuring a bot, connecting to an exchange, or writing strategy code, the agent reads these notes and answers with code patterns and command examples taken from the documentation. The skill itself does not place trades or connect to any exchange.
- Reference topics include advanced, configuration, development, trading and troubleshooting notes.
- Quick-reference patterns cover market data provider calls, candle retrieval, gateway commands and the quickstart script.
Install the hummingbot skill
Download the ZIP for this skill from this page and unzip it. Place the resulting hummingbot folder in one of the locations below, depending on how you want to use it.
You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.
- Personal use: unzip into ~/.claude/skills/
- Single project: unzip into the project's .claude/skills/ folder
Check the files after installing
The skill folder should contain SKILL.md at its top level and a references/ folder with advanced.md, configuration.md, development.md, index.md, trading.md and troubleshooting.md. SKILL.md holds the trigger description and the quick-reference patterns, and the reference files hold the longer documentation excerpts.
If the references folder is missing, the agent will only have the summary in SKILL.md and will have less detail to work from.
- SKILL.md
- references/advanced.md
- references/configuration.md
- references/development.md
- references/index.md
- references/trading.md
- references/troubleshooting.md
Trigger the skill with natural requests
The skill loads when your request matches its description, which mentions Hummingbot, trading bots, market making, arbitrage and exchange integrations. You do not need a special command. Name Hummingbot in your request so the match is clear.
Specific questions work better than general ones. Mention the part of the framework you need, such as a connector, a strategy, a gateway command or a market data call.
- How do I get a candle feed from KuCoin for ETH-USDT in Hummingbot?
- Show me the gateway swap help output in Hummingbot and what its arguments mean.
- How do I start the simple_pmm example config with the quickstart script?
- Which market data provider method returns the order book snapshot for a Binance pair?
Use the code examples safely
The examples in the skill come from documentation excerpts. Read each one before you run it, and check it against the current Hummingbot documentation, because the notes are auto-generated and may be outdated.
The skill's own files do not run scripts and do not use the network. Running Hummingbot itself, or connecting it to live exchanges, is a separate step that needs its own setup and exchange API keys. Test on paper or small amounts first and never run unreviewed code with real funds.
- Requires the Hummingbot framework only if you want to run the code examples.
- Requires exchange API keys and accounts only if you run bots against live exchanges.
- Does not run scripts and does not use the network.
- Do not rely on it for current exchange behaviour or fees.
Get better answers from the agent
Tell the agent which Hummingbot task you are doing and paste the error or config you are working with. The troubleshooting and configuration notes are most useful when the question includes concrete details.
Ask the agent to cite which reference file an answer came from, so you can open it and verify the wording yourself.
- Name the exchange, trading pair and connector you intend to use.
- Paste the exact command output or error message.
- Ask for the smallest runnable example rather than a full bot.
- Verify fees, limits and exchange rules on the exchange's own site.
What people use it for
- Writing a market making or arbitrage strategy script and checking the method calls against documentation examples.
- Learning how Hummingbot configuration files and the quickstart script are structured.
- Looking up how to request candles, prices, volume-based prices or order book snapshots through the market data provider.
- Reading gateway command help output to understand connector and argument order before you test anything.
- Debugging a Hummingbot error by comparing your setup with the troubleshooting notes.
Frequently asked questions
Is the hummingbot agent skill free?
The source for this skill is published under the MIT licence, which is stated on this page. The skill itself is a folder of documentation files, so you do not pay to install it. Hummingbot and any exchange you connect to have their own terms and costs that this skill does not cover.
What do I need to use the hummingbot skill?
You need an AI agent that supports skills, such as the Claude apps or Claude Code, to load the folder. You need the Hummingbot framework only if you want to run the code examples, and exchange API keys only if you run bots against live exchanges.
Does the skill trade for me or connect to an exchange?
No. The skill only supplies documentation and examples. It does not place trades or connect to any exchange, and it does not run scripts or use the network.
Where do I install the hummingbot skill?
Unzip the downloaded folder into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder for a single project. You can also upload it in the Claude apps under Settings, then Capabilities, then Skills.
Why is the agent giving outdated fees or exchange behaviour?
The notes are auto-generated from documentation and may be outdated. Check current fees, limits and exchange behaviour on the exchange's own site and in the current Hummingbot documentation before relying on them.
How is this different from using Hummingbot's own docs or other trading bot tools?
This skill is a reference helper for an AI agent, so it answers questions using saved documentation excerpts. It is not a trading service and not a live tool. For a hands-on setup or a managed bot, you would use Hummingbot itself or a different product.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are a developer or quant writing or debugging Hummingbot strategy scripts and want an agent that answers from documentation-style examples. Skip it if you want a bot to trade for you with real money, or if you need current exchange fees and behaviour, since the notes may be outdated and the code must be reviewed before it runs.
Download the skill