Balance Limit
Updated on version 0.35.0
Sets the amount limit on how much assets Hummingbot can use in an exchange or wallet. This can be useful when running multiple bots on different trading pairs with same tokens e.g. running a BTC-USDT pair and another bot on ETH-USDT using the same account.
How It Works¶
You can set how much of a particular token the bot can use by running the command balance limit [exchange] [asset] [amount]
. You can disable this feature by editing it in the global config file and set it to -1. While setting it to 0 will initially not place any order for a specific asset until a trade is executed to accumulate the said asset.
For example:
>>> balance limit binance USDT 100
Limit for USDT on binance exchange set to 100.0
Run the balance
command again or balance limit
to confirm the limit has been applied.
>>> balance
Updating balances, please wait...
binance:
Asset Amount Limit
BNB 0.0000 -
BTC 0.0000 -
ETH 0.0000 -
TFUEL 0.0187 -
THETA 0.5880 -
USDC 0.0090 -
USDT 158.8197 100.0000
XRP 0.8440 -
XZC 0.0076 -
>>> balance limit
Balance Limits per exchange...
binance
Asset Limit
USDT 100.0000
Example Scenario¶
Create pure market making strategy, run config
to view the whole configuration.
Run balance limit binance ETH 0.0513
to set the balance limit to 0.0513 ETH. Run balance limit binance USDT 30
to set the balance limit to 30 USDT. Both ETH and USDT value is equivalent to $30.
Each order is 0.0188 equivalent to $11.20
Sell order gets filled. USDT available balance is now 30.1657
Another sell order gets filled, the available balance now shows 41.2069. Plus the open buy order, the "usable" balance on USDT is now at around $52.
After the two sell orders gets filled the remaining available balance in ETH is 0.0137 equivalent to $8.17. It means that after the next order_refresh_time
it won't create sell order because the minimum order amount is $11.
Same process as the scenario above. After the two buy orders gets filled the remaining available balance in USDT is 7.5317 equivalent to $7.53. It means that after the next order_refresh_time
it won't create buy order because the minimum order amount is $11.