Launch Hummingbot Miner

Adding Transaction Costs

Info on adding transaction costs to prices

Updated as of v0.28.0

This feature lets you take into account the transaction cost incurred on the exchange from bid and ask orders. For a bid order, it reduces the bid order price by the fee. For the ask order, it reduces the price by the fee. This allows you to take into account the transaction cost in order to profit (or not incur a loss).

This puts your order prices further away from the mid price.


Whether to enable adding transaction costs to order price calculation.


Do you want to add transaction costs automatically to order prices? (Yes/No)
>>> Yes

How It Works

When the add_transaction_costs parameter is set to True, the client adds the transaction costs to the prices and adjusts the price proposal.

Type config add_transaction_costs to set the value for the parameter. If you respond Yes, the parameter is set to True, and if you type No, the parameter is set to False. This parameter is set to False by default.

Note that we currently display warnings if the adjusted price post adding the transaction costs is 10% away from the original price. If the buy price with the transaction cost is zero or negative, it is not profitable to place orders and orders will not be placed.

Order Price Calculation with Transaction Cost

Below fee_pct refers to the percentage maker fees per order (generally common in Centralized exchanges) while fixed_fees refers to the flat fees (generally common in Decentralized exchanges).

Calculating the Bid Order Price

Bid price with transaction cost

Calculating the Ask Order Price

Ask price with transaction cost

Example - When Transaction Cost is Important

You are market making for the ETH-USD pair. The order_amount parameter is set to 1, and the bid_spread and ask_spread as set to 1 (representing 1%). Suppose the mid-market price of ethereum and USD is \$200. When the add_transaction_costs is set to False, the bid order price is 1% below the mid-market price and the ask order price is 1% above the mid-market price, $198 and $202, respectively. Suppose the fee percentage (fee_pct) is 1% and the fixed fee (fixed_fees) is $0.50 for each transaction. The spread above does not take into account these transaction costs, and could hurt your profit. Your potential profit without taking into account the fees is $4. The fees incurred could be 1 dollar plus 1% times the value traded 1% x (199 + 200), which equals $3.99. Instead of profiting $4, you are losing $4 - ( $3.99 + $1) = - $0.99. When the add_transaction_costs is set to True, (using the formula above) the ask order price is $203 and the bid order price is $197. The profit before the tranaction fees is $6. The transaction fees amount to $1 + .01 ( $197 + $203) = \$5.

Thus, your profit is \$1. Here, adding the transaction costs to the calculations was the difference between a loss and a profit.

Edit on GitHub