> 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/features-and-setup.md).

# Features & setup

Every setting of the DCA form, from the entry and averaging orders to the exits, the repeat and the start conditions.

You set up goodcryptoX's DCA bot on the Trade page, in the form beside the chart: when and how it enters, its averaging orders, its exits and what happens after each cycle. It can start at once, at a set time or on a signal from TA rating, RSI, MACD, Bollinger bands or a price move.

First, connect your exchange account in **Settings › Exchanges**. On **Trade**, choose your account and pair, then select **Bots** and **DCA** in the right column. The bot's PnL is in the pair's quote currency, such as USDC.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-002063bb1c74e73d6ae7b8800bb9773254895e37%2Fdca-setup-1-bots-tab.webp?alt=media" alt="The bot form, the arrow at Bots" width="430"><figcaption></figcaption></figure>

**Only this bot trades this pair** is ticked for a new bot unless a position is already open on that perp. Leave it ticked if nobody else will trade this pair in this account, neither you nor another bot. When another bot is on the pair the box is unticked and a short line under it names that bot (with "and others" when there are several); if that bot has it ticked, launching this one turns it off for both. When orders that are not a bot's already rest on the pair (yours, or ones placed on the exchange), a second line says how many ("2 orders already open"); it is a warning only, and the bot's notice names them once it runs. This choice does not prevent other trading; see [Running the bot](https://docs.goodcrypto.app/goodcryptox-3.0/dca-bot/running-the-bot.md#when-the-bot-needs-you) if a position needs review.

Choose when to enter:

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-c76ac8c050c25ecc72a068ca580b07f06eb11a6c%2Fdca-setup-2-entry-condition.webp?alt=media" alt="The bot form, the arrow at Signal" width="300"><figcaption></figcaption></figure>

**Entry condition** — **Manual** starts each cycle after its start time and cooldown. **Signal** waits for your **Start when** conditions. Choose TA rating, RSI, MACD, Bollinger bands or Price move; use **+ Add condition** to combine them.

**Start when** — choose the state and candle intervals for each indicator. Buy and sell signals count separately: a buy signal needs every condition with a buy state ticked to show it on every selected interval (Buy on 5m AND 15m needs both), and a condition with no buy state ticked doesn't hold it back; sell signals work the same way. For example, with Bollinger bands at the upper band, RSI oversold or overbought and the price rose, on Inverse the bot goes long when all three hold and short on RSI oversold alone. Buy includes Strong Buy; Sell includes Strong Sell. Select only the intervals you want the bot to wait for. The candle menu offers more intervals; all your selected intervals must agree, including those outside the visible strip. Check all your selections before launching.

#### Start on a signal

<details>

<summary>TA rating</summary>

The TA rating combines 26 indicators into one rating for each candle period. Choose **Strong Buy**, **Buy**, **Sell** or **Strong Sell**. Buy includes Strong Buy; Sell includes Strong Sell. Tick the periods you want, such as 5m and 15m. The whole selection must agree at the same time: every ticked period, not just any one. DCA can enter while the candle is still forming; Grid waits for the candle close.

</details>

<details>

<summary>RSI</summary>

RSI measures the strength of recent rises against falls over 14 candles. **Oversold** means RSI is at or below 30 at the candle close; **Overbought** means at or above 70. Choose the state and tick the candle periods you want. Every ticked period must meet it.

</details>

<details>

<summary>MACD</summary>

MACD compares fast and slow moving averages to show momentum, with fixed settings of 12, 26 and 9. **Bullish cross** means MACD crosses above its signal line; **Bearish cross** means it crosses below. The cross must be on the latest closed candle of every period you tick.

</details>

<details>

<summary>Bollinger bands</summary>

Bollinger bands sit two standard deviations above and below the 20-candle average, showing how far price is from that average. Choose **Price ≤ lower band** for a close at or below the lower band, or **Price ≥ upper band** for a close at or above the upper band. Every candle period you tick must meet the chosen condition.

</details>

<details>

<summary>Price move</summary>

Choose **Fell** or **Rose**, a positive percentage and a whole duration in minutes, hours or days. **Fell 10% in 7 days** means within a week or any shorter stretch: price is at least 10% below the highest price since the wait began, looking back at most seven days. For example, a move from 100 to 112 and then 100.8 qualifies: price fell 10% from 112. **Rose** measures a rise from the lowest price in the same window. Earlier moves do not count. Each DCA cycle begins a new wait; choose the duration to match the move you want to trade.

</details>

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-fe4aaea643b91fa09ebea488f632604bff3a2867%2Fdca-setup-2b-price-move.webp?alt=media" alt="The Start when block with a TA rating and a Price move condition, the arrow at the Price move percentage" width="430"><figcaption></figcaption></figure>

## Entry side and mode

**Entry side**, with Manual, chooses a **Buy order** or **Sell order**. On spot, Sell needs coins you own.

**Entry mode**, with Signal: **Direct** buys on buy-side agreement and sells on sell-side agreement; **Inverse** reverses those sides. Mixed readings, or both sides agreeing together, wait. Check the Long and Short lines (Buy and Sell on spot): each says when the bot enters, or "never" and why. A condition whose percentage you have not typed yet is named without it. The bot holds one position at a time and ignores further entry signals until that position closes.

## Entry order

Next, choose how to enter:

**Entry type** — **Market** enters at market when the cycle starts. **Limit** waits at your **Limit distance**: with price 100 and a 5% distance, a Buy limit is 95 and a Sell limit is 105. Each new cycle measures from its starting market price. Choose Limit when you want to wait for a better price.

**Trailing Stop**, the default, follows a falling price and buys on a rebound by your **Trailing distance**. Starting at 100, a fall to 90 with a 10% distance gives a trigger of 99. A Sell entry works the other way round. Averaging orders are always Limit orders.

**Margin**, on perpetuals, shows the exchange's margin mode and leverage for the coin and changes them where supported. On a coin whose leverage you've never set, that is the exchange's own default, which can be Cross at the highest leverage, so check it before you launch. A change goes to the exchange as soon as you pick it, as in the order form; if the exchange refuses it, the reason shows under the row and the row goes back to what the exchange has. If the exchange still has another leverage when you launch, the bot runs at the exchange's and tells you which after Launch. Check [Margin and liquidation](https://docs.goodcrypto.app/goodcryptox-3.0/dca-bot.md#margin-and-liquidation) before using leverage. With % of account, DCA and Grid size their orders using your chosen leverage, including in portfolio margin. In portfolio margin, a refused leverage change is shown as a warning; the bot can still submit orders.

## Investment and entry size

**Investment** — the planned total of your entry and averaging orders. Orders of 100, 200 and 400 total 700. Type Investment and the app works out the sizes from it, keeping the ladder's shape, and shows them in grey; type the sizes and Investment shows their total in grey. Changing any of the ladder's settings after typing Investment works the sizes out again. Choose **% of account** to use a share of your account value, including unrealized PnL: it targets Approx. margin on perpetuals, the most your account needs for the bot to reach its stop loss, and the orders' total on spot.

**Entry size** — the first order's value in the quote currency, or quantity in the coin. Averaging orders use the same unit. We suggest sticking with the quote currency for **Entry size**, unless you want a fixed coin amount at each level. Typing Entry size returns Investment to the quote currency.

Sizing in the quote currency keeps the planned funds and potential profit broadly similar from cycle to cycle as the coin price changes. A fixed coin size needs less money, and earns less at the same percentage target, when price falls; it needs more money as price rises.

### Coin-margined markets

On a coin-margined (inverse) futures market, size the bot in USD or in the coin it settles in. The coin is the default.

* **In USD**, every order puts up the same dollars, times the multiplier. As the price falls, the same dollars buy more of the coin. On a contract worth 100 USD, an entry of 300 USD with ×1.5 sends 300, 400, 600 and 1,000 USD: 450 and 675 round down to 400 and 600.
* **In the coin**, every order puts up the same amount of the coin, times the multiplier, at that order's own price. As the price falls, the same coin is fewer dollars. On a contract worth 1 USD, an entry of 3.52 HYPE at 71 sends 249 USD, and an averaging order of 7.04 HYPE at 70.29 sends 494 USD.

Sizes worked out from Investment are rounded down the same way. Every order is rounded down to what the market trades: for example, steps of 100 USD on Binance's BTC contract, 10 USD on its others and 1 USD on Bybit. An averaging order that rounds to nothing is not placed; an entry that does holds the bot until you press Retry or Stop. When you leave a USD **Entry size** or **First averaging order** field, it snaps down to that step: 250 becomes 200 on a contract worth 100 USD. A size in the coin stays as you typed it, and the planned orders show what each one sends.

**Investment** and **Approx. margin** are in the coin the market settles in, the coin your account holds. A bot sized in the coin has the coins you typed as its Investment (3.52 + 7.04 = 10.56 HYPE, whatever the price); a bot sized in USD has an Investment that moves with the price.

## Reinvest

**Reinvest** — adds realized profit after fees and funding to future cycles; losses reduce them. With 700 invested and 70 profit, the next planned cycle is 770. With % of account, Reinvest stays on because account value already includes the result. Review **Orders list** after changing sizes.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-efae0d504ee59caf83dafd94d9343bba915541ad%2Fdca-setup-3-entry.webp?alt=media" alt="The bot form, the arrow at Investment" width="430"><figcaption></figcaption></figure>

## Averaging orders

Now set the averaging ladder:

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-ffa3bb906f339d2a40e026fc010c447397511546%2Fdca-setup-4-averaging.webp?alt=media" alt="The bot form, the arrow at Averaging orders" width="430"><figcaption></figcaption></figure>

**Averaging orders** — the number of additional orders, from 0 to 100. Buy averaging orders go below entry; Sell averaging orders go above it. Choose the count for the price range you want to cover.

## Averaging orders on the exchange

**On exchange** — **One at a time**, the default, activates each averaging order at the previous planned price, even if the previous order has not filled. **All at once** places the limits after entry begins filling. Distant orders may wait for the exchange to accept their prices. **Post only** can refuse an order that would fill immediately.

## First averaging order

**1st avg order** — **Auto** applies your size multiplier and price step from the first averaging order. Choose **Manual** to give that first order its own settings:

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-ed763ea9ca749884cf821bf5ccd3f62084654ae0%2Fdca-setup-4b-first-averaging.webp?alt=media" alt="The bot form, the arrow at Manual under 1st avg order" width="430"><figcaption></figcaption></figure>

**1st avg size** sets the first averaging order's value or coin amount. For example, enter 20 in your selected unit. Use it when the first addition should differ from the rest of the sequence.

**1st avg step** sets the first averaging order's distance from entry. For a Buy entry at 100, 10% places it at 90; later gaps begin at your **Avg price step**, for example 5%. Check the preview to see both distances.

## Averaging size multiplier

**Avg size multiplier** — how much each order grows from the previous one. At 1, sizes stay equal; at 2, each doubles. A first averaging size of 2 and multiplier 3 gives subsequent sizes of 6 and 18. A multiplier below 1 makes each subsequent order smaller. In Auto, the first averaging size is your entry size times this multiplier. Choose larger multipliers only with the whole ladder's total in mind.

## Averaging price step

**Avg price step** — the basic percentage gap between averaging orders.

**Avg step multiplier** — widens or narrows later gaps: above 1 widens them, below 1 narrows them, and 1 keeps the same percentage step. With a 2.5% price step and multiplier 1, every gap is 2.5%. At multiplier 2, the first order is 2.5% below entry, the second 2.5% below the first, the third 5% below the second, and the fourth 10% below the third. Check the ladder rather than assuming every gap doubles from entry.

## Exits

Next, choose your exits. Both are optional:

## Take Profit

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-496717c8dd251217b2b5a74b4b3e94d9275fadc7%2Fdca-setup-6-take-profit.webp?alt=media" alt="The bot form, the arrow at the Limit take profit" width="300"><figcaption></figcaption></figure>

**Take Profit** — the distance from your average entry, 3% by default. An average of 95 gives a target of 97.85. It follows averaging fills unless fixed to entry or moved to breakeven.

* **Limit** rests on the exchange and fills at its price or better.
* **Market** closes at market when price reaches the target.
* **Trailing** starts following at **Trailing start**. It follows a favourable move at **Trailing distance** and closes at market on a reversal. Once trailing begins, averaging orders and Stop Loss are canceled.

### Trailing Take Profit

**Trailing start** is the distance from the position's average entry at which Take Profit begins following the market. **Trailing distance** is how far behind the favourable price it follows: below a rising price for a long, above a falling price for a short. It stays fixed when price reverses and closes at market when touched.

For a long with an average entry of 100, a 10% start activates at 110. With a 2% trailing distance the trigger there is 107.80; if price rises to 120 it follows to 117.60. These percentages apply to different prices, so subtracting the distance from the start percentage is only an approximation. Check the projected exit in the setup.

### Take Profit from entry

**TP from** chooses the position's average entry (VWAP) or the entry order price.

**Fix TP as % from entry order price** keeps the target tied to entry. Buying at 20,000 with 50% sets 30,000, however low you average. Choose it when that original price remains your target.

### Max distance from market price

**Max distance from market price** shows how far the target would be from price after all averaging fills.

> A Limit Take Profit works while goodcryptoX is off. Market and Trailing Take Profit, and Stop Loss, need goodcryptoX running. On spot, a Limit Take Profit must be canceled before Stop Loss sells, which can worsen the stop's fill price.

On spot, with a Limit take-profit and a stop-loss both on, the form says **May cause sell price slippage**. The take-profit order holds your coins, so the stop-loss cancels it before selling. See [Spot stop-loss with a Limit take-profit](https://docs.goodcrypto.app/goodcryptox-3.0/manual-trading/take-profit-and-stop-loss.md#spot-stop-loss-with-a-limit-take-profit) for the price and cancellation risks.

## Stop Loss

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-e5e0ffd48e5a5981c684e97c6d78830b7bd81ad5%2Fdca-setup-5-stop-loss.webp?alt=media" alt="The bot form, the arrow at the Stop Loss menu" width="300"><figcaption></figcaption></figure>

**Stop Loss** — the percentage distance from the last planned averaging order, or entry when there are none. For a Buy ladder ending at 80, a 5% stop is 76. It closes the bot's position and cancels averaging orders and Take Profit. The menu also offers **Max loss, %**: the estimated loss if every planned order fills and the position closes at the stop price, fees included, as a percentage of the Investment. The line under the field shows the other one and the loss in money: under a distance, the Max loss; under Max loss, the distance. Choose the distance for where you want to exit, then review its estimated loss.

On a Sell ladder the stop sits above the last averaging order. The stop sends a Market order when triggered. Its distance from that last order is not your total loss percentage: the sizes and prices of the whole ladder determine the result. The expected-loss figure uses the current setup and assumes every averaging order fills.

> Max loss is an estimate, not a guaranteed limit. It includes the fees on every order and on the stop, but not funding or credits. Gaps can make the loss larger, and on perpetuals liquidation can come first.

## Orders list

Press **Orders list** to review the entry, averaging orders, Stop Loss and Take Profit, with size, value, distance and price. **Total** is the whole ladder. An averaging order below the exchange's minimum says “may be refused”. The bot still sends it; if the exchange refuses it, the order fails and the bot keeps running. An order whose size rounds to zero says “not sent”.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-9e138ecd10e08ebd5f529cd5ccc84f3e85b4abfd%2Fdca-setup-7-orders-list.webp?alt=media" alt="The Orders list open in the bot form, the arrow at its title" width="300"><figcaption></figcaption></figure>

The chart draws the same ladder:

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-29ad084febb8839d1a7c04fd17c11d8db480adcf%2Fdca-setup-10-chart-ladder.webp?alt=media" alt="The Trade page while you set up the bot: the ladder on the chart" width="563"><figcaption></figcaption></figure>

## Repeating cycles

Then choose what happens after a cycle:

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-c685ab5e487bf180f08e02a8f4eb63117e66f769%2Fdca-setup-8-repeat.webp?alt=media" alt="The bot form, the arrow at Repeat after" width="300"><figcaption></figcaption></figure>

**Repeat after** — choose **TP** and **SL** separately. For example, repeat after TP and stop after SL. Closing the position yourself follows the TP choice; with Take Profit off, that choice reads **Close pos.**

**Cooldown** — the wait before another cycle. Five minutes lets the bot wait after an exit before starting again.

**Close pos. on stop** — on by default. Your Stop, an error or the end of a timed run also closes the position at market. Off leaves it yours to manage.

## Start time

**Start** — now, after a delay or at your chosen time. Signal and order-price conditions still need to be met.

## Run duration

**Run** — until stopped, for days or for cycles. With days, **finish the cycle** lets the last cycle reach its exit; unticked, the bot stops when the days end. Choose one cycle for a single pass through the plan.

**Notifications** — choose **Stop/error**, **TP/SL** and **Entry/avg orders**, with **From level** 0 including entry.

## Maximum position and funds

Finally, check the funds:

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-2f8ca1a3b22c6fcaab664eb59d2299358397697a%2Fdca-setup-9-launch.webp?alt=media" alt="The bot form with the liquidation warning, the arrow at Launch" width="430"><figcaption></figcaption></figure>

**Max position** is what the bot holds after entry and all averaging orders fill. Each order's size rounds down to the step the exchange trades in. On coins that trade in coarse steps and orders sized as an amount of money, that moves the figures with the price. The figures show what would be sent at the price now; on those coins the tooltips of **Max position**, **Max loss** and **Approx. margin** add a line, "…–… depending on the price". On spot, **Funds needed** shows the coins or quote currency needed for the ladder. On perpetuals, check **Approx. margin** and **Est. liquidation** before launching; see [Margin and liquidation](https://docs.goodcrypto.app/goodcryptox-3.0/dca-bot.md#margin-and-liquidation). Check the warning against your intended stop and averaging range.

Add a **Bot name** and **Note** if you like. Review the description under **Launch**, then launch. **Launch** asks once more and shows that description; press **Launch** in it to start the bot, or **Back** to leave the form as it is. Tick **Don't ask again** to skip the question; the switch **Launching a bot** in Settings brings it back. A trading warning asks with **Launch anyway** instead, and no second question follows. Check the named issue first, since the exchange may refuse the order.

<figure><img src="https://3159525366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fgit-blob-022fd17ea413223c7e1eddc27478aeb460354708%2Fdca-setup-11-running-message.webp?alt=media" alt="The message after Launch, the arrow at Details" width="300"><figcaption></figcaption></figure>

Open **Details** or find the bot in **Bots**. Check the position and working orders there before leaving the bot to trade. A delayed start waits for its time; Signal then waits for its conditions. If you have no answer after Launch, check **Bots** before trying again. Continue with [Running the bot](https://docs.goodcrypto.app/goodcryptox-3.0/dca-bot/running-the-bot.md).

## Questions

### How much money does a DCA bot need?

Its **Investment**: the planned total of the entry and all averaging orders, or a share of your account with **% of account**. On spot, **Funds needed** shows what the ladder needs; on perpetuals, **Approx. margin** does.

### Can the bot start on a signal?

Yes: with **Signal**, it waits for your **Start when** conditions from TA rating, RSI, MACD, Bollinger bands or Price move, on the candle intervals you choose. Buy and sell signals count separately: each needs every condition with one of its states ticked to show it on every selected interval.

### Does the bot work while goodcryptoX is off?

A Limit Take Profit works while goodcryptoX is off. Market and Trailing Take Profit, and Stop Loss, need goodcryptoX running.

### Can the bot repeat after Take Profit?

Yes: **Repeat after** chooses **TP** and **SL** separately, and **Cooldown** sets the wait before the next cycle.
