Skip to content

Manage a bot

Follow a running bot on its page, pause and resume it, change its settings, stop it with your choice of what happens to the position, and stop all your bots.

On this page

The Bots page lists your bots in two tabs: My bots (the ones running, paused or starting) and History (the ones stopped). Tap a row to open the bot's page.

The bot list

The summary above the list shows how many bots run (Running, for example 1 of 2), In bots, Total PnL and Today. Each row shows:

ColumnWhat it means
BotIts name (for example SOL Grid) with its direction, the type and leverage (futures), the venue and how long it has run, like 3d 4h
StatusRunning, Scheduled, Starting, Paused, Paused by Prow, Stopping or Error
In the botWhat the bot may use
Total PnLRealized plus unrealized, in USDC and %

Each row in My bots has Pause (or Resume) and Stop (Cancel start for a scheduled start). On a phone, each bot is a card with the same buttons, and Stop all sits at the end of the tabs.

History lists stopped bots. Its Stopped column says why: Stopped by you, Stop loss, Take profit, Max loss, Out of margin, Price left the range, Safety stop, Key expired, Key removed, Signed limits expired, Not enough balance, Account changed, Stopped by Prow or Error. Copy settings opens the builder with the same settings. The bin hides the row: press Remove to confirm, or Keep.

The same list sits under the chart in the bot builder, with an All bots row that adds them all up. On Portfolio, the Bots card and the Bots tab of the positions card show the bots that run, each with Manage (Resume on a paused one).

The bot's page

The page looks like Trade: the market's header, the chart with the bot's orders and fills (buy and sell orders, what it bought and sold, the stop loss, and how many more orders sit above and below), the order book, and the tabs under them. The panel on the right holds the bot:

  • Your bot on SOL-PERP (its market), the name, the status and how long it has run.
  • Total PnL, with Profit taken, Unrealized, Today, APR (after 1 day), In the bot and Trades. Right after a start, it says what the bot is placing and when the first numbers come.
  • Edit, Pause (or Resume) and Stop. A DCA bot that starts deals by hand also shows Start deal while no deal is open.
  • Settings: what the bot runs with, and Edit settings. After an edit, Started … with other settings shows the ones it started with.
  • Limits you signed: until when they are valid, the max loss and the markets. The bot key can place and cancel orders; it can't withdraw.

The tabs:

  • Position: the market, side and leverage, size, entry, mark, liquidation price and how far away it is, PnL, and the TP and SL, opened and managed by the bot.
  • Orders: the orders the bot has on the venue: side, type, price, size, its level (for example 16 of 25) and status, with the price now between the sells and the buys. Read-only: cancelling a bot order elsewhere pauses the bot.
  • Trades: for a grid, each completed pair with when it closed, buy price, sell price, size, profit and fees. For DCA and Ladder, each deal: opened, closed, extra buys used, average entry, exit, PnL and why it closed.
  • Log: everything the bot did, newest first: orders placed, filled and cancelled, take profit, stop loss, pauses, errors and your edits. Filter by Trades or Errors.

On a phone, one row of tabs holds Chart, Order book, Position, Orders, Trades and Log, the panel's figures follow, and Edit, Pause and Stop stay docked over the tab bar.

An arbitrage bot's page shows its pairs instead: see Manage it.

A spot hedge's page shows the short, the funding it collected, the short's PnL, your spot, the guard and the liquidation price, with Alerts, Pause and Stop, and the Chart, Orders, Settings and Log tabs.

Pause and resume

Pause cancels the bot's buy, sell and take-profit orders and opens nothing new. It keeps the position or coin and keeps the stop loss on the venue. A message confirms it ("Orders cancelled. The stop loss stays on Hyperliquid.") with Resume in it.

Resume rebuilds the orders from what the bot holds now: sell levels only for the coin or position it holds, buy levels below the price for the rest. It never starts a fresh grid on top of the old one.

When Prow pauses a bot

A bot shows Paused by Prow when it had to stop trading for your safety. Its page says why ("Prow paused SOL Grid: …") and offers Sign and resume. Its stop stays on. The usual reasons:

  • You traded the bot's market by hand on the same account, or cancelled one of its orders on Portfolio, on Trade or on the venue. The bot pauses so it doesn't fight you. If you cancel its stop loss while it holds a position, the bot puts the stop back once, and pauses if you cancel it again.
  • Not enough balance: something else used the bot's funds.
  • The account changed: on Aster, bots need one-way position mode and single-asset margin. If you change them, bots pause.
  • The bot key is about to expire (see below), or the limits you signed expire within the hour. From 3 days before, the bot's page says "SOL Grid's signed limits end on Nov 14." with Renew limits: one signature keeps it running with the same settings.
  • A safety stop: Prow's safety checks refused the bot's orders several times, or Prow switched bots to close-only.

Sign and resume opens Resume SOL Grid: it shows until when the limits are signed again and asks your wallet to sign them. The settings stay the same.

When a bot stops on an error, its page says what happened and what to do next (for example "Not enough free margin on Aster for the bot's orders. Add funds or lower the investment, then use Copy settings to start it again."), with Copy settings.

Edit a running bot

Edit (or Edit settings) opens Edit SOL Grid. It changes what doesn't touch the limits you signed:

  • Name, for every bot.
  • Grid: Take profit (stops the bot at a total PnL you set), Trailing take profit, and If the price leaves the range (Keep running, Stop and close or Stop and keep).
  • Ladder: Take profit and Trailing take profit.
  • DCA: Take profit, Trailing take profit, Trailing stop, Cooldown between deals and Repeat.

Press Save. The change applies within a few seconds and shows in the Log. The range, grids, leverage and stop loss (DCA: the investment, orders, leverage and stop loss) are part of the limits you signed. To change them, press Copy settings at the bottom of Edit: it opens the Stop dialog first (one bot runs per market and account), then the builder with the bot's settings, so the new setup gets its own check and signature.

Stop a bot

Stop opens Stop SOL Grid?. The bot cancels its open orders, then does what you pick. The dialog also shows the bot's Total PnL and the fees it paid.

BotOptions (the first is the default)
Futures grid, Ladder and futures DCAClose the position at market: closes with reduce-only orders within your slippage, and says roughly what that makes. Keep the position with its stop: it stays in your positions with the bot's stop as a normal order; Prow no longer moves or manages it. Keep the position without a stop: isolated at the bot's leverage with nothing protecting it. Set one on the position. Futures DCA also offers Wait for take profit, then stop: the current deal runs to its take profit or its stop, and no new one opens
Spot gridSell HYPE to USDC (with your coin), or Keep HYPE in your spot balance
Spot DCAClose deal at market, Keep HYPE, or Wait for take profit, then stop: the current deal runs to its close, and no new one opens

Press Stop bot. When it has stopped, a window shows the result: the final PnL, how long it ran, whether the position was closed, the profit taken, the closed (or open) position and the fees, with Copy settings and Back to my bots. The bot's page then shows the same result, with Copy settings and Back to bots.

A bot that hasn't placed anything just doesn't start: Cancel start says so.

An arbitrage bot offers two choices, and neither keeps a single leg: Close all pairs at market (the default) closes both legs of each pair together; Keep pairs with their stops leaves both legs open, each with its venue stop and the order that closes it when the other leg's stop fires. Pausing an arbitrage bot stops new pairs; open pairs stay managed and close by their rules. It has no Edit: its settings are part of its signed limits. See Arbitrage bot.

If a sale leaves an amount smaller than the venue's minimum order, it stays in your balance as a small leftover.

Stop all bots

Stop all, at the top of the Bots page (on a phone, at the end of the tabs), stops every bot you have, at once. Stop all bots? lists them with their status and PnL. From that moment no bot opens anything new. You pick one option for all of them:

  • Close positions at market (the default): futures bots close their positions with reduce-only orders within your slippage, spot grids sell the coin, spot DCA bots close their deal.
  • Keep positions with their stops: futures positions stay open with the bot's stop as a normal order, which Prow no longer manages. Spot coins stay in your balance.

The dialog shows their total PnL and fees. Press Stop 2 bots (with your count). It never asks for a signature or a second factor, so you can use it fast.

Arbitrage bots get the same choice for both legs of every pair: close all pairs, or keep them with their stops.

Your next bot start lifts the stop for new bots.

Notifications

Bots send notifications to the bell, and pushes on devices where push is on (see Alerts): started or scheduled, deals closed, take profit, stop loss (a stop moved to breakeven after a take profit comes as a plain "stop at breakeven" notice, not a stop-loss alert), paused, errors, liquidation, and key or limits about to expire. Completed grid pairs come as one summary every 30 minutes. A spot hedge also tells you when its liquidation price gets close (with how much margin to add), when the short starts paying funding, when your spot drops below the short, and at once when its guard closes it.

When the bot key expires

The Prow Bots key lasts 30 days. From 7 days before, the Bots page says "Your Hyperliquid bot key expires in 6 days (keys expire for safety)." Press Renew (1 signature) and sign once, and your bots switch to the new key on their own.

If you don't renew, the bot cancels its buy and sell orders an hour before the key expires and pauses, with its stop kept on the venue. See The Prow Bots key.

Last updated