Skip to main content

Troubleshooting

Common issues when trading and how to fix them.

← Trade overview · Fees


Before you can trade​

"Enable Trading" button appears​

Problem: You need to complete one-time trading setup.

Fix: Click Enable Trading and follow the prompts. This connects your BattleGrid account to Hyperliquid.


"Deposit to Trade" or "Transfer to Trade"​

Problem: Your trading account has no funds.

Fix:

  • Main account — Deposit USDC via the wallet flow
  • Team account — Transfer funds from Main to the team

You need available balance to place orders. The required amount depends on your position size and leverage.


Order rejected​

"Budget exceeded"​

Problem: The agent's budget couldn't cover the order's margin.

Fix: Either reduce position size, lower leverage, or increase the agent's budget in Risk management.


"Insufficient margin"​

Problem: Your account doesn't have enough free collateral for this order.

Fix:

  • Close other positions to free up margin
  • Deposit more USDC
  • Reduce position size or leverage
  • On HIP-3 markets, you may need to activate a unified account

"Below exchange minimum"​

Problem: Order size was below Hyperliquid's minimum notional ($10 for most coins).

Fix: Increase your position size. The minimum varies by coin.


"Order rejected" (generic)​

Problem: The exchange rejected the order after submission.

Fix: Check the error details. Common causes:

  • Price moved too far from your limit
  • Market conditions changed
  • Insufficient balance for the margin mode

Slippage issues​

"Slippage rejected"​

Problem: The expected fill price exceeded your max slippage setting before the order was sent.

Fix:

  1. Open Fee & Slippage Details on the order ticket
  2. Increase Max Slippage (e.g., from 1% to 2%)
  3. Try again

Higher slippage tolerance means worse fills are accepted. Lower means orders reject more often in fast markets.


Fill price different from expected​

Problem: Market orders fill at the best available price, which may differ from the displayed price.

This is normal. The Est. Slippage on the order ticket shows the expected deviation before you submit. Actual slippage depends on:

  • Order size vs available liquidity
  • How fast the market is moving
  • Time between submit and execution

For tighter fills, use Limit orders instead of Market.


Position issues​

"Liquidation"​

Problem: Your margin fell below the maintenance threshold, and the exchange closed your position.

What happened: Price moved against you far enough that your remaining margin couldn't support the position. The exchange auto-closed it to prevent further losses.

Prevention:

  • Use lower leverage (wider margin buffer)
  • Set stop-losses before liquidation price
  • Use Isolated margin mode to cap losses per position
  • Monitor your Cross Ratio (higher = safer)

TP/SL not triggering​

Problem: Price reached your take-profit or stop-loss level, but the order didn't execute.

Possible causes:

CauseWhat happened
Wick vs closePrice touched the level but didn't stay there — wicks can miss triggers depending on exchange timing
Limit executionIf you set TP/SL to Limit execution, the order rested at your price but may not have filled in a fast market
Order cancelledThe TP/SL was cancelled or replaced before it triggered

Fix: For guaranteed fills on TP/SL, use Market execution (the default). Limit execution avoids slippage but risks partial or no fill.


Can't open a second position​

Problem: The team you picked already has an open position on this coin.

This is intentional. BattleGrid allows each team only one position on a coin at a time. See One trade per team per coin.

Options:

  • Close the existing position first
  • Adjust the existing position's size
  • Use a different team account

Agent issues​

"Agent paused"​

Problem: The agent was paused just before placing the order.

Fix: Resume the agent in the Agents Hub or check why it was paused (drawdown stop, manual pause, etc.).


"Agent unavailable"​

Problem: The agent couldn't trade for your account when the order was about to be placed.

Fix: Check that:

  • The agent is active and not archived
  • Your account has trading enabled
  • The agent has permission to trade this coin

"Approval expired"​

Problem: You didn't approve the trade in time, and the entry window closed.

What happened: The agent found a valid setup, but you didn't respond before the candle closed.

Prevention: Approve or decline trade requests promptly when notified.


Timeout and connectivity​

"Timeout"​

Problem: The order submission timed out before the exchange acknowledged it.

Fix: Check your connection and try again. If the issue persists:

  • The exchange may be experiencing delays
  • Try a smaller order size
  • Wait a few minutes and retry

Orders not appearing​

Problem: You placed an order but don't see it in Open Orders.

Check:

  1. Trade History — it may have filled instantly
  2. Order History — it may have been rejected or cancelled
  3. Refresh the page — data may not have synced

Still stuck?​

If none of these solutions work:

  1. Note the exact error message
  2. Check what you were trying to do (coin, size, leverage, order type)
  3. Contact support with these details

← Trade overview · Fees