Appearance
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.
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.
| Setting | Meaning |
|---|---|
| Pair | Any active spot market where buying and selling are both enabled. The form opens with ±10% around the current price. |
| Lower price / Upper price | The range. The upper price must be above the lower price. |
| Grids | 2 – 150. The range is split into this many cells. |
| Spacing | Arithmetic: every cell is the same price step. Geometric: every cell is the same percentage. |
| Investment | In 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 bot | Pre-ticks the "sell" option in the stop dialog. |
How it runs:
- 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.
- A buy fills in a cell → the bot places a sell one line higher.
- 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.
| Setting | Meaning |
|---|---|
| Base order | First buy, at market, in the quote coin. |
| Safety order | Size of the first extra buy, in the quote coin. |
| Safety orders | How many extra buys, 0 – 25. 0 = only the base order. |
| Price deviation | Drop 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-profit | On: 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:
| Message | Fix |
|---|---|
| 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 deep | The 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 as | When | Sells the coin? |
|---|---|---|
| Take profit reached | Grid take-profit price reached, or a DCA bot without "new cycle" took profit | Grid: yes. DCA: it already sold |
| Stop loss reached | Grid stop-loss price or DCA stop-loss % | Yes |
| Stopped: error | Something the bot can't fix: balance gone, market closed, no liquidity for its first buy… The message is shown on the card | No |
| Stopped by support | An admin stopped it | No |
| Account deactivated | The account was deactivated or deleted | No |
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).
| Endpoint | Does |
|---|---|
GET /api/v1/bots | My bots (running first) and the bot settings |
GET /api/v1/bots/markets | Markets 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/preview | The plan without placing anything (422 with the message and the plan when something is wrong) |
POST /api/v1/bots/grid, POST /api/v1/bots/dca | Start a bot (10 per minute) |
POST /api/v1/bots/{id}/stop | Stop; 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.
