Cross Exchange Market Making
Learn how to use cross exchange market making strategies
How It Works
Cross exchange market making is described in Strategies, with a further discussion in the Hummingbot white paper.
Warning: Updates to strategy — The cross exchange market making strategy has been updated as of v0.15.0, so that it will always place the order at the minimum profitability level. If the sell price for the specified volume on the taker exchange is 100, and you set the min_profitability as 0.01, it will place the maker buy order at 99. The top depth tolerance is also now specified by the user in base currency units. Please do not use old configuration files for running this strategy.
Schematic
The diagrams below illustrate how cross exchange market making works. The transaction involves two exchanges, a taker exchange and a maker exchange. Hummingbot uses the market levels available on the taker exchange to create bid and ask orders (act as a market maker) on the maker exchange (Figure 1).
Buy order: Hummingbot can sell the asset on the taker exchange for 99 (the best bid available); therefore, it places a buy order on the maker exchange at a lower value of 98.
Sell order: Hummingbot can buy the asset on the taker exchange for 101 (the best ask available), and therefore makes a sell order on the maker exchange for a higher price of 102.
If a buyer (Buyer D) fills Hummingbot's sell order on the maker exchange (Figure 2 ❶), Hummingbot immediately buys the asset on the taker exchange (Figure 2 ❷).
The end result: Hummingbot has sold the same asset at \$102 (❶) and purchased it for $101 (❷), for a profit of $1.
Prerequisites
Inventory
- For cross-exchange market making, you will need to hold inventory on two exchanges, one where the bot will make a market (the maker exchange) and another where the bot will source liquidity and hedge any filled orders (the taker exchange).
- You will also need some Ethereum to pay gas for transactions on a DEX (if applicable).
Initially, we assume that the maker exchange is an Ethereum-based decentralized exchange and that the taker exchange is Binance.
Minimum Order Size
When placing orders on the maker market and filling orders on the taker market, the order amount should meet the exchange's minimum order size and minimum trade size.
You can find more information about this for each Exchange Connectors under Miscellaneous section.
Adjusting Orders and Maker Price calculations
If the user has the following configuration,
order_amount: 1 ETH
min_profitability: 5
and as per market conditions we have the following,
Sell price on Taker: 100 USDT (on a volume weighted average basis)
Top Bid price on Maker: 90 USDT (existing order on the order book, which is not the user's current order)
If adjust_order_enabled
is set to True
:
The bid price according to min profitability is 95 (100*(1-0.05)). However as top bid price is 90, the strategy will place the bid order above the existing top bid at 90.01 USDT
If adjust_order_enabled
is set to False
:
The bid price according to min profitability is 95 (100*(1-0.05)). Here the strategy will place the bid order at 95.
Basic Parameters
The following walks through all the steps when running create
command.
maker_market
The exchange where the bot will place maker orders.
Prompt:
taker_market
The exchange where the bot will place taker orders.
Prompt:
maker_market_trading_pair
Trading pair for the maker exchange.
Prompt:
taker_market_trading_pair
Trading pair for the taker exchange.
Prompt:
min_profitability
Minimum required profitability in order for Hummingbot to place an order on the maker exchange.
Prompt:
order_amount
An amount expressed in base currency of maximum allowable order size.
Prompt:
Tip: For autocomplete inputs during configuration, when going through the command line config process, pressing
<TAB>
at a prompt will display valid available inputs.
Advanced Parameters
The following parameters are fields in Hummingbot configuration files (located in the /conf
folder, e.g. conf/conf_xemm_[#].yml
).
adjust_order_enabled
If enabled, the strategy will place the order on top of the top bid and ask if it is more profitable to place it there. If disabled, the strategy will ignore the top of the maker order book for price calculations and only place the order based on taker price and minprofitability. Refer to Adjusting orders and maker price calculations section above. _Default value: True
active_order_canceling
If enabled, Hummingbot will cancel orders that becomes unprofitable based on the min_profitability
threshold. If disabled, Hummingbot will allow any outstanding orders to expire, unless cancel_order_threshold
is reached.
cancel_order_threshold
This parameter works when active_order_canceling
is disabled. If the profitability of an order falls below this threshold, Hummingbot will cancel an existing order and place a new one, if possible. This allows the bot to cancel orders when paying gas to cancel (if applicable) is a better than incurring the potential loss of the trade.
limit_order_min_expiration
An amount in seconds, which is the minimum duration for any placed limit orders.
top_depth_tolerance
An amount expressed in base currency which is used for getting the top bid and ask, ignoring dust orders on top of the order book.
Example: If you have a top depth tolerance of 0.01 ETH
, then while calculating the top bid, you exclude orders starting from the top until the sum of orders excluded reaches 0.01 ETH
.
anti_hysteresis_duration
An amount in seconds, which is the minimum amount of time interval between adjusting limit order prices.
order_size_taker_volume_factor
Specifies the percentage of hedge-able volume on taker side which will be considered for calculating the market making price.
order_size_taker_balance_factor
Specifies the percentage of asset balance to be used for hedging the trade on taker side.
order_size_portfolio_ratio_limit
Specifies the ratio of total portfolio value on both maker and taker markets to be used for calculating the order size if order_amount is not specified.
taker_to_maker_base_conversion_rate
Specifies conversion rate for taker base asset value to maker base asset value.
taker_to_maker_quote_conversion_rate
Specifies conversion rate for taker quote asset value to maker quote asset value.
Exchange Rate Conversion
From past versions of Hummingbot it uses CoinGecko and CoinCap public APIs to fetch asset prices. However, this dependency caused issues for users when those APIs were unavailable. Starting on version 0.28.0, Hummingbot uses exchange order books to perform necessary conversions rather than data feeds.
When you run strategies on multiple exchanges, there may be instances where you need to utilize an exchange rate to convert between assets.
In particular, you may need to convert the value of one stablecoin to another when you use different stablecoins in multi-legged strategy like cross-exchange market making.
For example, if you make a market in the WETH/DAI pair on a decentralized exchange, you may want to hedge filled orders using the ETH-USDT pair on Binance. Using exchange rates for USDT and DAI against ETH allows Hummingbot to take into account differences in prices.
maker_market: bamboo_relay
taker_market: binance
maker_market_trading_pair: WETH-DAI
taker_market_trading_pair: ETH-USDT
taker_to_maker_base_conversion_rate: 1
taker_to_maker_quote_conversion_rate: 1
By default, taker to maker base conversion rate and taker to maker quote conversion rate value are both 1
.
Our maker base asset is WETH and taker is ETH. 1 WETH is worth 0.99 ETH (1 / 0.99) so we will set the taker_to_maker_base_conversion_rate
value to 1.01.
While our maker quote asset is DAI, taker is USDT and 1 DAI is worth 1.01 USDT (1 / 1.01). similar to the calculation we did for the base asset. In this case, we will set the taker_to_maker_quote_conversion_rate
to 0.99.
To configure a parameter value without going through the prompts, input command as config [ key ] [ value ]
. These can be reconfigured without stopping the bot however, it will only take effect after restarting the strategy.
config taker_to_maker_base_conversion_rate 1.01
config taker_to_maker_quote_conversion_rate 0.99