Skip to main content

Close DCA Bot

Close a running DCA (Dollar-Cost Averaging) bot with a specified settlement mode.

info
  • Bot state requirement:
    The bot must be in a closeable state. Bots that are currently mid-investment cycle may not be closeable (returns status_code=503).

  • Settlement mode (close_mode):
    2: Base token mode — convert all holdings to base tokens
    3: Quote token mode — convert all holdings to quote token (e.g. USDT)

  • Rate limit:
    3 requests per second per UID.

HTTP Request

POST/v5/dca/close-bot

Request Parameters

ParameterRequiredTypeComments
bot_idtruestringDCA bot ID to close, obtained from Create Spot DCA Bot response
close_modetruestringAsset settlement mode: 2 Base token, 3 Quote token (e.g. USDT)

Response Parameters

ParameterTypeComments
status_codeinteger200 = success, non-zero = error
bot_idstringThe closed DCA bot ID
close_modestringThe settlement mode used, DCA_BASE_MODE, DCA_QUOTE_MODE
debug_msgstringDebug message (testnet only)

Request Example

POST /v5/dca/close-bot HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211928338
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"bot_id": "612349292702654770",
"close_mode": 2
}

Response Example

{
"retCode": 0,
"retMsg": "",
"result": {
"status_code": 200,
"bot_id": "612349292702654770",
"close_mode": "DCA_BASE_MODE",
"debug_msg": ""
},
"retExtInfo": {},
"time": 1774518356929
}