Skip to content

Trading Bots ​

Users can start Spot Grid and DCA bots that trade for them around the clock. A bot places normal spot orders on the user's Trading account, so its orders go through the same matching, fees and balances as orders placed by hand. The user can stop a bot at any time.

8 minutesUser featureSite owner, supportVerified against the platform code

Where it is

Header → Trade → Trading Bots (/bots). In the mobile app: Account → Trading Bots, or the robot icon on the Trade screen (opens bots for the pair on screen). Signed-out visitors see the introduction with Sign up to start and Log In.

The page ​

  • Bot types: one card each for Spot Grid and DCA, with a Create button. The buttons are disabled while bots are turned off in Admin → Trading Bots.
  • Running bots and Total profit (signed-in users) at the top.
  • Running / History tabs with one card per bot: pair, type, status and run time (or why it stopped), total profit, grid / cycle profit, investment, number of grid trades / cycles. Details and Stop on each running bot.

The list refreshes every 8 seconds while the page is open.

Spot Grid ​

Buys low and sells high inside a price range. Best when the price moves sideways.

SettingMeaning
PairAny active spot market where buying and selling are both enabled. The form opens with ±10% around the current price.
Lower price / Upper priceThe range. The upper price must be above the lower price.
Grids2 – 150. The range is split into this many cells.
SpacingArithmetic: every cell is the same price step. Geometric: every cell is the same percentage.
InvestmentIn the quote coin (e.g. USDT), taken from the Trading account.
Take profit price / Stop loss price (optional)When the last price reaches the take-profit price (must be above the current price) or falls to the stop-loss price (must be below it), the bot stops and sells its coin at market.
Sell the coin when I stop the botPre-ticks the "sell" option in the stop dialog.

How it runs:

  1. Start: for every cell above the current price the bot needs coin to sell later, so it first buys that coin at market in one order. Below the price it places limit buys at the bottom of each cell; above the price, limit sells at the top of each cell.
  2. A buy fills in a cell → the bot places a sell one line higher.
  3. A sell fills → the profit (sale − fee − what that coin cost) is added to Grid profit, and the bot buys again one line lower.

Until the user changes Grids by hand, the form picks a grid count that leaves each cell at least 2 × trading fee + 0.4% wide (at most 20), so the default settings don't lose money to fees.

DCA ​

Buys more as the price drops to lower the average cost, then sells everything at the take-profit.

SettingMeaning
Base orderFirst buy, at market, in the quote coin.
Safety orderSize of the first extra buy, in the quote coin.
Safety ordersHow many extra buys, 0 – 25. 0 = only the base order.
Price deviationDrop below the cycle's first price that triggers safety order 1 (0.1% – 50%).
Take profit% above the average cost at which the bot sells everything (0.1% – 100%).
Stop loss (optional)% below the average cost; reached → the bot stops and sells its coin at market. 0 or empty = off.
Step scale (Advanced)The gap between safety orders grows by this factor (1 – 5). With 1.5% and 1.2: −1.5%, −3.3%, −5.46%…
Volume scale (Advanced)Each next safety order is previous × volume scale (1 – 5).
Start a new cycle after each take-profitOn: after a take-profit the bot starts again with a new base order. Off: the bot stops after the first take-profit.

How it runs: base market buy → limit safety buys below → one take-profit sell for all the coin held. After each safety fill the take-profit is moved to the new average. When the take-profit fills, the cycle's profit goes to Cycle profit and the remaining safety orders are cancelled.

The preview ​

While the user types, the Summary asks the server what the bot would do (nothing is placed):

  • Spot Grid: current price, profit per grid after fees (red when negative), amount per grid, minimum investment, how many cells are bought at the start, the user's trading fee.
  • DCA: current price, total investment (all orders + fees), how far a drop the safety orders cover, and every safety order with its price and amount.

Problems are shown in the Summary and Create bot stays disabled until they are fixed. The most common ones:

MessageFix
Invest at least … for … grids.Each cell must reach the market's minimum order size.
The grids are too close: fees would eat the profit.Fewer grids or a wider range.
The range is too narrow for … grids at this price step.The cells would be smaller than the market's price tick.
Safety order … is below the market minimum.Raise the safety order amount.
The safety orders go too deepThe last safety order would be 95% or more below the start.
Not enough … in your Trading account.Transfer funds to the Trading account.
You can run up to … bots at a time.The per-user limit in Admin → Trading Bots.
Verify your identity to use trading bots.Only when Require KYC is on.

Details ​

Details shows total profit (current value of the bot's coin + quote vs. investment), grid / cycle profit, what the bot holds, fees paid, the settings, open orders and the last 50 filled orders with the profit of each sell.

Stopping a bot ​

Stop cancels every open order of the bot; the funds go back to the Trading account. Also sell the … the bot holds at market price sells the coin the bot bought (if it is at least the market's minimum order size). Untick it to keep the coin.

A bot also stops by itself:

Shown asWhenSells the coin?
Take profit reachedGrid take-profit price reached, or a DCA bot without "new cycle" took profitGrid: yes. DCA: it already sold
Stop loss reachedGrid stop-loss price or DCA stop-loss %Yes
Stopped: errorSomething the bot can't fix: balance gone, market closed, no liquidity for its first buy… The message is shown on the cardNo
Stopped by supportAn admin stopped itNo
Account deactivatedThe account was deactivated or deletedNo

The user gets a push notification (app) when a bot stops on take-profit, stop-loss or an error.

Bot orders can't be cancelled by hand

A bot's orders show up in Open Orders like any other order, but cancelling one is refused with This order belongs to a trading bot. Stop the bot to cancel its orders. This keeps the bot's accounting correct.

On the trade screen ​

The spot trade page (/market/{pair}, and the phone layout) links to bots for the pair on screen:

  • Grid bot (⚡) in the order-form header opens the Spot Grid form with this pair selected.
  • Bots tab in the orders area (next to Order History / Trade History) lists the user's bots on this pair with type, range or settings, investment, profit and status. The tab shows how many are running. Details and Stop open the bot on /bots.
  • In Open Orders, orders placed by a bot carry a Bot label and a View bot button instead of Cancel.

Links of the form /bots?bot=ID open that bot's details, &stop=1 opens its stop dialog, and /bots?type=grid&market=BTC-USDT opens the create form for a pair.

Fees ​

Bot orders pay the user's normal spot fees (VIP level). Fees are charged in the quote coin and are already counted in the profit numbers.

API ​

The same endpoints are used by the website and the app; API keys need read to list and trade to create or stop (permissions).

EndpointDoes
GET /api/v1/botsMy bots (running first) and the bot settings
GET /api/v1/bots/marketsMarkets bots can trade, with price and steps
GET /api/v1/bots/{id}One bot with open orders and filled history. Other users' bots answer 404
POST /api/v1/bots/grid/preview, POST /api/v1/bots/dca/previewThe plan without placing anything (422 with the message and the plan when something is wrong)
POST /api/v1/bots/grid, POST /api/v1/bots/dcaStart a bot (10 per minute)
POST /api/v1/bots/{id}/stopStop; sell: true also sells the coin

The bots need a running process

Bots only react to fills while the trading-bots process runs (Market Services). If it is stopped, bots keep their open orders but don't place the next ones.

Owner documentation for the CryptoTech exchange platform.