Documentation

Get Started

Your Hopper consists of many widgets. Here's a short overview of the function of every widget. 

Summary Open Positions

A summary off all your open positions. An easy way too see how much percent of each coin you have in your assets.

(BTC) Invested/Total (BTC) in Assets on exchange

This shows how much you have invested, how much percentage profit you have made, and what your start balance is. Make sure you fill in a correct start balance, so you will see exactly how much profit you've made.

It so happens that the (BTC) Invested is a bit off, you can reset those stats by clicking the reset button. When you've entered a correct start balance, the % Assets on exchange will always show a correct profit/loss. (As long as you do not manually withdraw or add coins to your exchange)

Open Orders

When your Hopper wants to buy a new position, it will create a limit order on your exchange. When this order is filled, a position is created and placed in your Open Positions list. You're able to perform a myriad of actions on these positions through bulk actions. You can cancel, hold, unhold, merge. split, sell, and remove your positions. You can also create a specific DCA order or set a percentage profit. More on this Here

Open Positions

When your Hopper buys a certain amount of a currency, a position is created. Here you can see multiple things.

  • Currency : What type of currency the position consists of
  • Amount : The amount bought 
  • Cost : The amount of base currency you paid for the position
  • Result : Percentage gain/loss if you were to sell the position
  • Age : How old the position is
  • Action : Here you can choose to sell the position or get more info on your position

Open positions Info

when you have an open position and click on the info button, a screen pops up with more information and possibilities regarding the selected position.

Date:
At which date the position has been made.
Age:
How old the position is in minutes, hours, days.
Currency:
What type of currency was used.
Trading pair:
What kind of trading pair was used, this is (Base currency/Currency).
Amount:
The amount of currency purchased.
Cost:
The amount of base currency paid for the position.
Buy rate:
At what rate in your base currency the position was bought.
Current rate:
At what rate in your base currency the position is currently in.
Stop-loss rate:
At what rate the stop loss will trigger (if you set it).
Wether the trailing stop loss is armed or not, and if armed, at what price it will attempt to sell.
Result:
The profit/loss you would make if you were to sell the asset with the current rate.
Buy trigger:
What triggered your hopper to buy this position, a signal given by a signaler, or strategy for example.
Buy order ID:
Each transaction gets a unique ID so it is trackable for you and for the support staff in case you ever need help.
Hold position:
If you enable this option, the hopper will ignore profit/loss and HODL!
Sell position:
If you press this button the hopper will immediately attempt to sell the position.
Split position:
If you decide to split your position, it will create two smaller positions containing 50% of the old position.
Remove position:
Removing a position will cause it to de-sync and be removed from your hopper, in order to make a position again, you will have to sync your assets.

Hopper Controls

These are those big green/red buttons. You're able to enable/disable your whole Hopper, Buying and/or Selling.

Note: As long as your Hopper is disabled, it will not sync to your exchange.

Panic Button

The panic button places limit sell orders for your current positions and disables your hopper.

Warning: It could be that sell orders are not getting filled, please check this yourself in your exchange account.

Manual Buy Order

Create your custom limit order here. When filled in, your Hopper will place it on your exchange. You are able to configure a specific percentage profit, sell price and trailing buy option.

Current Target

You can read here which currencies your Hopper is targeting. Targeting means that your Hopper will try to buy the currency that is targeted. 

A target is set according to your Multiple TA settings, if they indicate that the hopper should buy, and at least two give a buy signal, the hopper will target the asset.

Manual Target

If there's a particular currency you want your Hopper to buy, create a manual target, and your Hopper will try to buy it within the specified time period.

Current Assets

Here you can see your current assets, available on the exchange. Always make sure you have enough of your base currency, as your Hopper will try to buy with that particular currency.

If there are currencies on your exchange that you would like to import, use the synchronize button.

The Wallet Scrubber is used to sell currencies on your exchange that are too small to sell. The wallet scrubber will attempt to buy the minimal trading pair amount for that currency and sell them.

Synchronize

This tool shows you the assets on your exchange that you can import. Only coin pairs that can be imported are shown here. For example, your base currency is ETH, and you have a position on your exchange that can only be traded with BTC, you will not be able to import this coin.

You can fill in the rate at which you bought the coin. You can find this rate in your order history on your exchange.

You can also turn on Automatic sync. Be careful with this option, as you may have position on your exchange that you do not want to import.

Wallet scrubber

Note: This tool does not function properly on Binance.

This tool allows your hopper to ''pick up'' leftover positions or ''Dust'' (positions that fell in price and are now not possible to be sold according to the minimum order requirement). It will place a buy order for the coin in question, combine that with your leftover amount, and then sell the full amount. Be careful with this feature. Sometimes the process fails because the price falls again. This can leave you with unsold orders, open positions, and possible loss or profit.

Cryptohopper Output

One of the most important places of your dashboard. This is the place to see what your hopper is doing.

The hopper will output two types of messages : 

  • INFO 
  • ERROR

Both types of output are very handy to understand.

The INFO notification usually indicates a successful buy or sell and if you are selling for a profit.

The ERROR notification usually indicates a problem. It could be a faulty API key or an insufficiency of balance. Should you get ERROR messages on your hopper, try to figure out what exactly the error means, most of the time the error explains it all!

You can find a list of different errors and their meaning Here

Last Signal Output

This is an important place as well. It will show the last received signal and the actions your Hopper has taken using that signal.