Skip to main content

What is the Bot Doctor?

Is your bot not trading? The Bot Doctor runs a series of checks on your trading bot and helps you fix issues like a disabled bot, missing funds, config errors, or a missing strategy.

Written by Bryan

Is your trading bot not trading? The Bot Doctor is a tool that helps you find out what might be preventing your bot from working. It runs a series of checks on your bot, shows you which checks need attention, and gives you a button to fix most issues directly — without having to search through your config yourself.

You can find the Bot Doctor in the bottom-right corner of your bot's dashboard. Click the orange "Issues" button to open it. The number on the button shows how many issues were detected.

The orange Issues button of the Bot Doctor in the bottom-right corner of the dashboard

The Bot Doctor checks, multiple things:

1. Is the bot enabled?

A disabled bot won't scan the market or open any trades. If your bot is turned off, the Bot Doctor flags it as the first issue. Click "Enable bot now" to turn your bot on immediately — there's no need to go back to the dashboard.

Bot Doctor check 'Is the bot enabled?' with the Enable bot now button

2. Is buying and selling enabled?

Even when your bot is enabled, it will not trade if buying and selling are disabled in your config. Buying and selling can also be disabled separately, so your bot might only be opening positions, or only closing them. Click "Enable buying & selling" to enable both at once.

Bot Doctor check 'Is buying and selling enabled?' with the Enable buying selling button

3. Does the bot have any config errors?

If your config contains an active error, the Bot Doctor shows you the exact error message and which setting is causing it. A common example is invalid API Keys, as in the screenshot below. Click the button to go directly to the setting, adjust it, and don't forget to resave your config afterwards.

Bot Doctor check 'Does the bot have any config errors?' showing an invalid API key error and the Go to exchange config button

If the error message says your API Key or private key seems to be invalid, create a new set of API Keys on your crypto exchange and update them in your config. Refer to our exchange-specific articles on "How to connect to your exchange" for step-by-step instructions.

4. Do you have enough funds for the minimum buy amount?

Your bot needs enough of the quote currency to place an order of at least the minimum buy amount configured in your config. If your balance is lower than that, your bot can't open new positions.

If you use a paper trading bot, you can deposit your quote currency directly through the Bot Doctor. Fill in the amount and click the deposit button.

Bot Doctor funds check for a paper trading bot with an amount field and the Deposit EUR button

If your bot is connected to a crypto exchange, you can't deposit directly through the Bot Doctor. Instead, the Bot Doctor shows your current quote currency balance and the amount you need for your bot to make a trade. Deposit the missing funds via your crypto exchange account, or convert other cryptocurrencies you own into the quote currency.

Bot Doctor funds check for a bot connected to an exchange showing the retrieved balances

5. Do you have a strategy or signals configured?

Without a strategy, signal subscription, or TradingView alerts, your bot has nothing to base its trades on — so it won't open any positions. If you use TradingView, check whether it is properly set up. Otherwise, the Bot Doctor offers several ways to fix this issue: pick a ready-made strategy, configure your own strategy, or subscribe to signals in the Marketplace.

Bot Doctor check 'Do you have a strategy or signals configured?' with buttons to pick a strategy, configure a strategy, or subscribe to signals

6. Are there any errors in your bot output log?

The Bot Doctor also scans your bot output for error messages, so you don't have to read through the entire log yourself. It shows you the errors it found, together with a button to go to the setting that causes them. This often points you to the same root cause as the config check above — for example, invalid API Keys.

Bot Doctor check 'Do you have any weird errors in your bot output log?' showing an API key error from the output log

7. Your bot should now be fully operational!

Once all checks pass, the Bot Doctor no longer shows any issues and your bot is ready to trade. Do you still encounter issues that you can't resolve with the Bot Doctor? Contact Cryptohopper's support via the chat function on the Cryptohopper website.

Did this answer your question?