Skip to content

Rate Oracle

This new feature provides real time, most up-to-date exchange rate on any given token or currency from a reliable and trustworthy data source.


Use rate oracle with the cross exchange market making and arbitrage strategies.



The source where you want to pull data from, it can either be Binance, Coingecko, Kucoin or Ascendex. Please take note that using Coingecko will have a 30-second delay due to their API rate limit.

What source do you want rate oracle to pull data from? (binance, coingecko, kucoin, ascend_ex)"


This is a token which you can display other tokens' value in. Set the global_token.global_token_name according to your preferred token value.

What is your default display token? (e.g. USDT,USD,EUR)


The symbol for the global token.

What is your default display token symbol? (e.g. $, €)


If you happen to start the bot and produce the error Oracle rate is not available, or ff the rate_oracle_source fails to show any price reference on your pair, you may change the oracle_source by running config rate_oracle_source and switch between Binance, Coingecko, Kucoin or Ascendex.

How it works

If you need to view the rate oracle conversion after the balance, pnl, open_orders, trades, and status command, set it manually in the conf_client.yml.


In past versions of Hummingbot (1.5.0 and below), the conf_client.yml file is named conf_global.yml

To set the parameters for rate_oracle_source, global_token.global_token_name and global_token.global_token_symbol, run the config command.

Refer to the example below:

Change the default setting in conf_client.yml to GBP (Great Britain Pound). The conversion will show up when you run balance command.

The conversion also shows up during the status command for the liquidity_mining strategy. Under the Miner section.

The conversion shows up when using the pnl command.

The conversion also shows up when running the trades command.

The conversion also works with the open_orders command.