Skip to content


Snippets of Python code that let users customize a strategy.


Scripts were an early experiment to let users customize strategies, but a script's functionality is limited because it runs in a separate process. Going forward, we plan to make strategies easier to create and customize, so scripts will be deprecated.

Available strategies

How it works

After configured, the script will start automatically once a strategy starts and it stops when the strategy stops. The script is run on a new dedicated process, in case where the script fails or has a bug, your main Hummingbot application can still function.

Create your own script

  1. Create a new script file, you can see examples in the Examples section below, and save it into scripts folder
  2. Configure your Hummingbot
  3. Inside Hummingbot run command config script_enabled and/or config script_file_path.
  4. Editing conf_global.yml file using a text editor.
    script_enabled: true
  5. Start running a strategy

The following examples can be found in /scripts folder.

The most basic example only a few lines of code.

Replicates our current ping pong strategy using script.

Replicates our current price band strategy using script.

Demonstrates how to set the band around mid price moving average, the band moves as the average moves.

Demonstrates how to adjust bid and ask spreads dynamically based on price volatility.

Provides you a base template to start using the scripts functions.

Script base class

See this article for a description of the methods in the Script Base class.

Updating your scripts

We sometimes add/remove/edit commands in the helper scripts along with certain new features like the Scripts we released in version 0.29.0, and you would need to update your scripts.

Copy the commands below and paste them into the shell or terminal to delete the old scripts and download the most recently updated ones.


rm -rf
chmod a+x *.sh


rm -rf
curl -o
curl -o
curl -o
chmod a+x *.sh

Last update: 2021-12-15
Back to top