設置斷線保護時間

信息

什麼是斷線保護 (Disconnection Protect)?

Bybit基於websocket私有連接和心跳機制，提供斷線保護功能。這計時從第一次斷開開始。如果Bybit服務器在一段時間內沒有收到客戶端的重連超過10秒（默認）並 恢復心跳“ping”，則客戶端處於“斷線保護”狀態，客戶所有活躍的合約 / 現貨 / 期權訂單將自動取消。如果在 10 秒內，客戶端重新連接並恢復心跳“ping”，計時會在下次斷線 時重置並重新開始。

如何啟用斷線保護

若您需要開啟/關閉斷線保護功能, 您可以諮詢客戶經理. 開啟後，默認的斷線保護時間為10秒。

適用對象

作用於反向永續 / 反向交割 / USDT 永續 / USDC 永續 / USDC 交割 / 現貨 / 期權 (統一帳戶2.0)
作用於USDT 永續 / USDC 永續 / USDC 交割 / 現貨 / 期權 (統一帳戶1.0)

提示

API請求發送成功後，系統需要一定的時間才能生效。建議10秒後再查詢或設置。

• 您可以使用該接口來查詢當前DCP配置
• 您的私有連接必須訂閱斷線保護, 才能確保DCP功能被觸發

HTTP請求

POST /v5/order/disconnected-cancel-all

請求參數

參數	是否必需	類型	說明
product	false	string	OPTIONS(默認), DERIVATIVES, SPOT
timeWindow	true	integer	斷線保護時間窗口. [3, 300], 單位: 秒

響應參數

無

請求示例

HTTP

POST v5/order/disconnected-cancel-all HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1675852742375
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json

{
  "timeWindow": 40
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.set_dcp(
    timeWindow=40,
))

Java

import com.bybit.api.client.config.BybitApiConfig;
import com.bybit.api.client.domain.trade.request.TradeOrderRequest;
import com.bybit.api.client.domain.*;
import com.bybit.api.client.domain.trade.*;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();
var setDcpOptionsRequest = TradeOrderRequest.builder().timeWindow(40).build();
System.out.println(client.setDisconnectCancelAllTime(setDcpOptionsRequest));

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
    key: 'apikey',
    secret: 'apisecret',
});

client
    .setDisconnectCancelAllWindow('option', 40)
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

響應示例

{
    "retCode": 0,
    "retMsg": "success"
}