跳至主要内容

關閉網格機器人

以指定的結算模式關閉一個正在運行的現貨網格機器人。

信息
  • 機器人狀態要求:
    機器人必須處於可關閉狀態(NEWRUNNING)。已處於 CANCELLINGCOMPLETED 狀態的機器人無法再次關閉(返回 status_code=405)。

  • 結算模式(close_mode):
    2:基礎幣模式 — 將所有資產轉換為基礎幣
    3:報價幣模式 — 將所有資產轉換為報價幣(例如 USDT)
    4:基礎幣 + 報價幣模式 — 按原樣返回資產,不做轉換

  • 頻率限制:
    每個 UID 每秒最多 3 次請求。

HTTP請求

POST/v5/grid/close-grid

請求參數

參數是否必需類型說明
grid_idtruestring要關閉的網格機器人 ID,從創建現貨網格機器人響應中獲取
close_modetruestring資產結算模式:2 基礎幣,3 報價幣(例如 USDT),4 基礎幣+報價幣

響應參數

參數類型說明
status_codeinteger200 = 成功,非零 = 錯誤
debug_msgstring調試信息(僅測試網)

請求示例

POST /v5/grid/close-grid 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": "612340768081708828"
}

響應示例

{
"retCode": 0,
"retMsg": "",
"result": {
"status_code": 200,
"debug_msg": ""
},
"retExtInfo": {},
"time": 1774513501331
}