history

See the past performance of the current bot.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
>>>  history

  Recent trades:                                                                                     
      symbol   price  amount order_type  side   market            timestamp  fee_percent    flat_fee / gas
  0  ETHUSDT 203.913       1      limit   buy  binance  2020-05-26 08:30:19            0          None  
  1  ETHUSDT 203.863       1      limit   buy  binance  2020-05-26 08:30:32            0          None  
  2  ETHUSDT 203.597       1      limit  sell  binance  2020-05-26 08:31:44            0          None  
  3  ETHUSDT 203.613       1      limit   buy  binance  2020-05-26 08:31:59            0          None  

Inventory:                                                                                         
      Market Asset  Starting   Current Net Delta Trade Delta                            
  0  binance   ETH   10.0000   10.0000    0.0000      2.0000                            
  1  binance  USDT  500.0000  499.9840   -0.0160   -407.7920                            

Markets:                                                                                           
      Market     Pair Start Price       End Price  Trades Trade Value Delta             
  0  binance  ETHUSDT     203.913  203.6150000000       4  -0.56200000 USDT             

Performance:                                                                                       
  Started: 2020-05-26 08:31:34                                                                     
  Duration: 0 days 00:00:29                                                                        
  Total Trade Value Delta: -0.562 USDT                                                             
  Return %: -0.0222 % 

How It Works

The history command in Hummingbot will show the current session's past trades, inventory, duration, market trading pair performance, and return percentage.

Trade Value Delta

Total Trade Value Delta is calculated as the difference between the total assets acquired and total assets spent, specified in quote value.

trade\_value\_delta = (acquired - spent)

To get the quote value of base asset (acquired or spent), multiply the base value to end price.

1
2
3
4
5
6
7
8
Inventory:                                                                 
      Market Asset  Starting   Current Net Delta Trade Delta               
  0  binance   ETH   10.0000   10.0000    0.0000      2.0000               
  1  binance  USDT  500.0000  499.9840   -0.0160   -407.7920               

Markets:                                                                   
      Market     Pair Start Price       End Price  Trades Trade Value Delta
  0  binance  ETHUSDT     203.913  203.6150000000       4  -0.56200000 USDT

After executing these trades we acquired 2 ETH equivalent to 407.23 USDT (2 ETH * 203.615) and spent 407.7920 USDT tokens.

1
2
Trade Value Delta = (407.23 USDT - 407.7920 USDT)
Trade Value Delta = -0.562 USDT

Return Percentage

Return is calculated based on assets spent and acquired during trades, i.e. balance changes due to the inventory like deposits, withdrawals, and manual trades outside of Hummingbot do not affect the calculation.

Return\ \% = trade\_value\_delta / starting\_quote\_value

1
2
3
4
5
6
7
8
Inventory:                                                                 
      Market Asset  Starting   Current Net Delta Trade Delta               
  0  binance   ETH   10.0000   10.0000    0.0000      2.0000               
  1  binance  USDT  500.0000  499.9840   -0.0160   -407.7920               

Markets:                                                                   
      Market     Pair Start Price       End Price  Trades Trade Value Delta
  0  binance  ETHUSDT     203.913  203.6150000000       4  -0.56200000 USDT

Using the same example, get the starting quote value. Convert the starting ETH amount to USDT by multiplying to the start price and add the amount of quote assets. So we started with 2,039.13 USDT worth of ETH (10 ETH * 203.913) and 500 USDT total of 2539.13 USDT.

1
2
Return % = -0.562 USDT / 2539.13 USDT
Return % = -0.0222 %

Net Delta

Net Delta is the difference of your starting balance and current balance i.e. it takes into calculation assets spent & acquired during trades, deposits and withdrawals.

Trade Delta does not take into account deposits and withdrawals, only balance changes after executing trades in Hummingbot.

net\_delta = starting\_balance - current\_balance

1
2
3
4
Inventory:                                                                 
      Market Asset  Starting   Current Net Delta Trade Delta               
  0  binance   ETH   10.0000   10.0000    0.0000      2.0000               
  1  binance  USDT  500.0000  499.9840   -0.0160   -407.7920               

Using the same example, after executing these trades we can calculate Net Delta for base and quote assets, so Net Delta for base asset is 0.0000 because we started with 10.0000 ETH and current also 10.000 ETH. Net Delta for quote asset is -0.0160 USDT because we started with 500.0000 USDT and current is 499.9840 USDT, it means we lost -0.0160 USDT on quote asset.