Close Grid Bot

Close a running futures grid trading bot. The bot will cancel all pending grid orders and close positions.

info

• Bot state requirement:
  Only bots in a running state can be closed. The bot_id can be obtained from the Create Futures Grid Bot response or from Get Futures Grid Bot Detail.

• After closing:
  Use Get Futures Grid Bot Detail to check the final PnL and close reason.

• Rate limit:
  10 requests per second per UID.

HTTP Request

POST/v5/fgridbot/close

Request Parameters

Parameter	Required	Type	Comments
bot_id	true	string	Bot ID to close, obtained from Create Futures Grid Bot response

Response Parameters

Parameter	Type	Comments
status_code	integer	0 = success, non-zero = error
bot_id	string	The closed bot ID
debug_msg	string	Debug message (testnet only)

---

Request Example

POST /v5/fgridbot/close 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": "612330315406398322"
}

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "status_code": 200,
        "debug_msg": "bot has already been canceled",
        "bot_id": "612330315406398322"
    },
    "retExtInfo": {},
    "time": 1774508410683
}