create_bot
Create a trading bot on Gainium in one step with all settings passed directly, eliminating the need for a separate update call.
Instructions
Create a new bot in a single step — no follow-up update needed. The top-level properties cover the most common fields. For any field from discover(target: "bot") that is NOT listed here (e.g. startOrderType, useMoveTP, moveTPTrigger, moveTPValue, stopLossTimeout, takeProfitTimeout, dcaOrdersMultiplier, dcaStepMultiplier, trailingTP, trailingTPPerc, indicators, timers, and any other discovery field), pass them inside the 'settings' object — it is transparently merged into the request body at creation time. This avoids a create→update two-step. Use discover(target: 'bot', botType) to discover all available fields and defaults. The 'futures' and 'coinm' fields are auto-detected from the exchange — do not provide them. Requires write API key permission.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| botType | Yes | Bot type | |
| exchangeUUID | Yes | UUID of the exchange connection to use | |
| paperContext | No | Paper trading context (true = paper, false = real). Default: false | |
| pair | Yes | Trading pairs as array of {base}_{quote} strings, e.g. ["BTC_USDT"]. For Grid bots pass a single-element array — the server unwraps it automatically. | |
| name | No | Bot name | |
| strategy | No | Trading direction. Default: LONG | |
| baseOrderSize | No | Size of the initial base order, e.g. "100" | |
| orderSize | No | Size of each DCA/grid order, e.g. "100" | |
| orderSizeType | No | Order size reference currency. Default: quote | |
| tpPerc | No | Take profit percentage, e.g. "1.5" | |
| slPerc | No | Stop loss percentage, e.g. "-10" | |
| step | No | Price deviation % for next DCA/grid order, e.g. "1.5" | |
| ordersCount | No | Maximum number of orders (DCA/Combo) | |
| gridLevel | No | Grid level count (Combo only) | |
| maxNumberOfOpenDeals | No | Maximum concurrent open deals, e.g. "1" | |
| topPrice | No | Top price for grid range (Grid only) | |
| lowPrice | No | Low price for grid range (Grid only) | |
| budget | No | Total budget for grid (Grid only) | |
| levels | No | Number of grid levels (Grid only) | |
| gridType | No | Grid distribution type (Grid only) | |
| startCondition | No | Condition to start a new deal. Default: ASAP | |
| useDca | No | Enable DCA orders. Set false for a single base-order bot. | |
| useSl | No | Enable stop-loss. When true, slPerc is used. | |
| moveSL | No | Enable trailing stop-loss (move SL as price moves in your favour). | |
| moveSLTrigger | No | Profit % at which trailing SL is activated, e.g. "1.0" | |
| moveSLValue | No | Trail distance % for the moving SL, e.g. "0.5" | |
| startOrderType | No | Order type for the base (start) order. Default: market | |
| settings | No | Transparent passthrough for any bot settings field from discover(target: "bot") that is not listed as a top-level property above. All keys are merged flat into the request body — use this to create a fully-configured bot in a single call. |