> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-3.0/dca-bot/running-the-bot.md).

# Running the bot

What a running DCA bot shows, and how to change it, pause it, stop it or close it.

Once goodcryptoX's DCA bot runs, you follow it in the Bots list on the Trade page and in its details: position, orders, profitability and progress. You can change its settings while it runs, stop it, or copy it to start another.

## The Bots list

On **Trade**, open **Bots** under the chart and choose **DCA**:

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-ebc8910cf038a877473609247b03a6831fc53f3f%2Fdca-running-1-bots-list.webp?alt=media" alt="The Trade page with the Bots list under the chart, the arrow at a bot" width="563"><figcaption></figcaption></figure>

| Column                  | What it shows                                                                                                          |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Status dot and **Time** | Point at the dot for status. Time is creation while active, ending when done.                                          |
| **Instrument**          | Pair and account.                                                                                                      |
| **Bot**                 | Your name for the DCA bot.                                                                                             |
| **Progress**            | **avg 2/8** means two of eight averaging orders filled; **cycle 3** is the current cycle. Failed orders appear in red. |
| **Position**            | Coin amount and dollar value.                                                                                          |
| **R · U · APR**         | Realized PnL, unrealized PnL and yearly rate so far.                                                                   |

Click a heading to sort, or a row for details. A bot's row has **Stop** while it runs and **Copy** once it has stopped, then **Chart**; **Copy** fills the form with this bot's settings. **Stop all** stops the running bots the filtered list shows, after confirmation, and says how many stopped and how many are stopping. A bot whose order's cancel the exchange never answered reads "An order of this bot needs a decision" while it stops: **Retry** on its item sends that cancel again; **Refresh** on the order's details asks the exchange about it. A bot still stopping, or still launching with a market entry, 5 minutes after it began sends you one message and shows in Needs attention: **Refresh** on its close order asks the exchange; a launch has **Stop** beside it.

## The bot's details

The details open in the right column, from the top down.

### The header

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-9cc3991d5602e5c106d52625775af51f1bf0b529%2Fdca-running-2-header.webp?alt=media" alt="The bot&#x27;s details, the arrow at Chart" width="300"><figcaption></figcaption></figure>

The header names the account, pair and bot, with status, cycle, position and total PnL. Use **+ Add a name** or **+ Add a note** to help identify it. Next to the bot's status, a red count such as **3 errors** tells you how many averaging orders failed.

* **Stop** cancels all the bot's orders, including Take Profit and Stop Loss. With **Close pos. on stop** on, it also closes the position; otherwise you keep it.
* **Close pos.** closes at market and ends the cycle. Another cycle needs **Repeat after** with **TP** selected, subject to Run, cooldown and entry conditions.
* **Chart** shows the bot on the chart.
* **Fix failed** sends every failed averaging order again at its price. The wrench on a failed order's row sends just that order.
* **Start now** starts a scheduled bot's entry process immediately.
* **Copy** fills the form with these settings. Change what you like and press Launch to start another bot.

### Parameters

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-38e0ab459beedb87d85bea95fb4af698a8c72c50%2Fdca-running-3-parameters.webp?alt=media" alt="Parameters open, the arrow at the Investment value that applies from the next cycle" width="300"><figcaption></figcaption></figure>

Open **Parameters** to edit settings. Confirm with ✓ or Enter; × or Escape cancels.

**Reinvest**, the signals in **Entry condition**, **Close pos. on stop**, **Repeat after**, **Cooldown**, **TP from**, **Run**, **finish the cycle** and **Only this bot trades this pair** apply at once. Reinvest affects the next cycle's order sizes. Signal changes apply while the bot waits for an entry; this cycle's orders stay as they are. **Avg orders post only** applies at once, from the next averaging order the bot sends. Other changes apply next cycle while one is open. For example, changing Entry size from 100 to 150 leaves this cycle's entry unchanged. The next cycle's value appears below the current one; enter the current value again to cancel the change. See [Features & setup](https://docs.goodcrypto.app/goodcryptox-3.0/dca-bot/features-and-setup.md) for field meanings.

**BE** on the **Take Profit** line (**Move to breakeven**) sets this cycle's take profit at a price that covers the position's cost and the fees paid so far, not the closing fee. With the take profit off, it adds one there. Later averaging orders don't move it.

For a bot set up with Max loss, % before 3.2.1, the percentage now refers to the Investment: 20% of margin at 10x is shown as 2%. The stop price stays the same.

A bot launched before 3.2.1 sends the orders it had held back for the exchange's minimum as soon as it runs on 3.2.1.

A stopped bot allows only its name and note to change. Use Copy to prepare another trading plan.

### Orders list

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-b8081a664b0dc5a7e2efe711e706dc3203b6315d%2Fdca-running-4-orders-list.webp?alt=media" alt="The bot&#x27;s Orders list, the arrow at its title" width="300"><figcaption></figcaption></figure>

This is the planned ladder for the selected cycle: entry, averaging orders, Stop Loss and Take Profit, with size, value, distance and price. Failed orders are red; an order too small to send at all is grey. Use it to check which averaging levels remain before your stop.

### Profitability

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-aaccc366f2c467d25834bf78f5b1eb2f4c44f294%2Fdca-running-5-profitability.webp?alt=media" alt="Profitability with Realized PnL opened, the arrow at its chevron" width="300"><figcaption></figcaption></figure>

**Total PnL** combines **Realized PnL** and **Unreal. PnL**: +20 realized and −30 unrealized means −10 total, before closing fees. Open Realized PnL to see trading result, exchange fees, platform fees and funding. Unrealized values the open position at the last traded price.

**Invested** is the bot's investment; **Own funds**, on perpetuals, is what the bot needs from your account to reach its stop loss, the figure **Approx. margin** showed on the form. Choose a base:

* **Max planned** — the largest planned entry-and-averaging total of a cycle so far, at the top of its range when the exchange's step is coarse.
* **Max reached** — the most funds used at one time.
* **Average** — the funds used on average over running time.

PnL percentages use Max planned. **APR** projects the realized return over a year; **ROE** shows realized return on those funds. Neither promises future earnings. The chart shows realized PnL bars and an APR line; historical APR is estimated, and older history may show only the current point.

When a cycle was sized with Reinvest, **incl. … reinvested** shows profit included in this cycle's sizes, or a negative amount after losses. Account-percent sizing has no separate line.

### Position

**Bot position** is this bot's share. For example, it may hold 0.1 ETH within your account's 1 ETH. **Account position** shows the whole position when it differs. **Average** is the account's average on perpetuals, the bot's on spot.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-a566446bd87108fafddbc74ae5ca8829287f2697%2Fdca-running-6-position.webp?alt=media" alt="The bot&#x27;s Position, the arrow at Average" width="430"><figcaption></figcaption></figure>

**Liquidation** is the exchange's liquidation price. **Leverage** and **Margin** belong to the account position. Changing leverage affects that whole position and resizes unfilled account-percent averaging orders; the bot's position and exits keep their sizes.

### Averaging before liquidation

**No avg order before liquidation** means there is no remaining averaging order between the current price and the account position's liquidation price. An averaging level beyond liquidation cannot help before the exchange liquidates the position. Compare the remaining ladder, Stop Loss and liquidation price; the warning does not promise that an order before liquidation will prevent it.

### Progress, Notifications and the cycle's orders

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-4f4553b84f13ec1c36339b5bd38cceceae35b7ac%2Fdca-running-7-progress-activity.webp?alt=media" alt="Progress and the cycle&#x27;s orders, the arrow at the next-cycle arrow" width="430"><figcaption></figcaption></figure>

**Progress** shows the cycle and runtime. Use the cycle arrows to review another cycle's orders. Click an order for its fills, fees and times; **Show more** opens more activity. **Show funding** includes funding payments. Liquidation and auto-deleveraging appear as **Liquidation** and **ADL** in red. An open order of a stopped or errored bot offers **Cancel**; Cancel all leaves bot orders alone.

On Hyperliquid spot, while you have other orders on the same coin, the bot places its limit orders as post-only, so one your balance doesn't cover is refused instead of canceling your other orders. One that would fill at once, and a market entry, go after goodcryptoX checks your balance. Its stop-loss goes as it is.

## What goodcryptoX tells you

Choose **Stop/error**, **TP/SL** and **Entry/avg orders** in Notifications; From level 0 includes entry. Messages report later fills, automatic changes and stops. Errors and problems needing your decision arrive regardless of these switches.

## When the bot needs you

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-dc971288c4c9dacdc9ec3f93f98bdb3cfff7dbc8%2Fdca-running-8-needs-you.webp?alt=media" alt="A bot that needs a decision, the arrow at Retry" width="300"><figcaption></figcaption></figure>

**Needs repair** names the problem and offers actions such as **Retry**, **Close position** or **Stop bot**. The bot takes no new risk while existing exits keep working. Read what each choice will do before confirming.

With Only this bot trades on, an unexpected position difference may need a decision: **Exchange is right** accepts the exchange position; **Bot is right** keeps the bot's count. A notice about other resting orders offers **Accept** or **Stop bot**; the bot keeps running meanwhile.

A failed averaging order does not stop the bot. Its row says **Error**; open it to see why, and press **Retry** to send it again. [When an order fails](https://docs.goodcrypto.app/goodcryptox-3.0/manual-trading/when-an-order-fails.md) explains each refusal. When the bot ends, **Copy** prepares another.

### Accepting the exchange position

**Exchange is right** previews the position the bot will count: size, average price and realized PnL. A zero position has no average price; its realized PnL still remains. Read these figures before accepting.

If the known trades do not explain the whole difference, the preview also shows a **Correction**. This changes the bot's count without inventing a trade or profit: the correction itself has zero PnL. The preview can show a remaining position or zero, with or without a correction.

### A refused sale

The choices depend on why the exchange refused the sale. **Retry** sends the displayed size again at market. If fewer coins are available than the bot counted, **Exchange is right** sells what is available to the bot; the cycle ends if nothing remains.

If the rest is below the exchange's minimum, accepting it removes that rest from the bot's count as a zero-PnL **Correction**. The coins stay in your account and the cycle ends as that exit would have ended it.

When your other orders hold the coins the bot needs to sell, **Cancel that order** cancels enough of those orders and retries the sale. Review the orders named before choosing it.

### Matching the account to the bot

**Make the exchange match the bot** cancels every other order resting on the coin in this account, your own included, and buys or sells at market to restore the position the bot counts. Before confirming, read the side, size, target position, approximate cost, maximum cost and estimated fee. Only the fee affects the bot's profit; the repair trade does not become strategy profit.

A thin-orderbook warning means the price may move more than 25%. The cost is an estimate, not a promised fill. This choice changes the account, so it can affect trading outside this bot too.

## Questions

### Can I change a running bot?

Yes: open **Parameters** and edit a setting. Some apply at once; the others apply from the next cycle while one is open.

### What happens when I stop the bot?

**Stop** cancels all the bot's orders, including Take Profit and Stop Loss. With **Close pos. on stop** on, it also closes the position; otherwise you keep it.

### What if an averaging order fails?

The bot keeps running, and a failed averaging order doesn't go into **Needs your attention**: the Bots list counts it. **Fix failed** sends failed averaging orders again at their prices; the wrench on a failed row, or **Retry** when you open it, sends just that one. You get one Telegram message while averaging orders remain failed. A later refusal after you send them again can send another message, as can a refusal in a new cycle. Immediate retry failures are shown in the bot.

If an averaging order was refused because it was post only and would have filled at once, turn off **Avg orders post only** in **Parameters** and press **Fix failed**. The change applies to the next order the bot sends; orders already on the exchange stay as they are.

### Is funding included in the bot's result?

Yes: on perpetuals, funding paid or received is included in the bot's result. Open **Realized PnL** to see it beside the trading result and fees.

### Why did my bot's profit change overnight?

Once a day, at 00:00 UTC, Hyperliquid sells any coin balance too small to trade (worth 1 USD or less). If some of those coins were your bot's leftovers, the sale counts in the bot's realized PnL.
