Troubleshooting

Insufficient Margin

If you receive an "Insufficient Margin" error (often indicated by a red warning), your available collateral is too low. Running the bot with insufficient margin will likely lead to your order being cancelled. To resolve this:

• Add more funds to your exchange account

• Reduce the notional amount of your order

• Check your account's margin settings (e.g., cross vs. isolated) on the exchange website

• Check that your balance is in your perp account, not your spot account (common issue for Hyperliquid where the balances are separted).

Common Issue: Using Nearly All Available Margin Another common issue occurs when users try to use almost their entire margin balance for market making. For example, if you only have $10 of available margin and you input $10 in Margin. While our system allows this, during the order execution it has a high chance of getting stuck with the insufficient margin error because there is insufficient margin left to open up new orders to help keep your exposure balanced during the bot's operation. To avoid this, we recommend leaving a buffer (e.g., use only 50%of your available margin) to allow the bot to manage exposure adjustments.

'Paused' Status

If you see your bot's status change to 'Paused', do not be alarmed. This is a built-in safety feature. The bot pauses itself automatically when its market exposure in one direction (long or short) grows too large. It will resume trading once its net exposure is reduced to a safe level.

Insufficient Balance for Spot

For spot market making, ensure you have at least half the recommended margin/balance in the base token to fund sell orders:

• The 50/50 Rule: To market make a Spot pair, you need 50% of the total value in the base token and 50% in the quote token.

  • Example: To market make $1,000 worth of HYPE/USDH, you must hold $500 worth of HYPE and $500 USDH in your wallet.

• Check Your Wallet: Ensure these funds are in your Spot Account, not your Perpetual/Futures account.

Order Not Submitting

Verify all required fields are filled, check your API key permissions, and ensure you have a sufficient balance/margin.

Cancelled Market Maker Orders

Upon canceling a market maker bot order, an automatic order will be placed to close any residual positions known as a clean-up order. This ensures you finish with a net zero balance. However, if you are seeing that your bots are not fully closing your position upon stop loss or cancel:

1. Wait at least 15 seconds: It takes a couple of seconds for the order to close out your position to be visible on the UI and to start executing. This is by design to ensure that there are no pending fills coming in for the bot.

2. Verify if clean-up was submitted:

   • Go to the Orders tab (from the top nav bar) and filter for single orders

   • Find order with Strategy: TWAP , clicking into it, under the notes section it should also say say "Exposure cleanup for order:..." and if it is not fully filled → click into it to see further order details

   • View the order messages for any error messages.

3. Common Error Messages: If there is an order message that says something along the lines of:

   • "Reduce only order increases position"

   • "Position is missing for reduce-only order"

   The problem is that you had an open position for the pair before the bot ran.

4. How Cleanup Works: When the bot is canceled, it looks at the last state of total exposure (the size of the position that the bot has opened). It will create a REDUCE ONLY TWAP over 1-15 minutes (depending on the size of the exposure) which will close out the exposure.

5. Why Cleanup Fails: The main reasons why some cleanups fail are:

   • Pre-existing position: If you had an open position before starting the bot, let's say you had 1 ETH long, and the net exposure was -2 ETH at the end of the bot, your position on the exchange is -1 ETH. The cleanup of +2 ETH will fail because the order will try to reduce only buy 2 ETH, but you only have -1 ETH. This can happen with even a small amount of dust.

   • Manual position closure: You manually closed out a position while the bot was running. The exposure is not accurate and this can happen for the same reason as above.

   • Outages: There was an outage where the bot lost track of orders (unexpected exchange or Tread outages).

6. How to Mitigate:

   • Don't leave dust (small residual orders) when starting bots

   • Don't manually trade the same asset while the bots are trading

   • If all fails, close out the exposure manually and (optional) cancel the clean-up TWAP. The second step is optional because reduce only orders will automatically fail anyway if you don't have an open position on the exchange.