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 %