跳至主要内容

試點功能

Open API支持模擬交易​

  • 可用日期: 測試網 - 已上線, 主網 - 2024年4月3日
  • 覆蓋範圍: 模擬交易賬戶
  • 詳細內容: 您可以參閱該頁面進行體驗

websocket下改撤單功能​

  • 可用日期: 測試網 - 已上線, 主網 - 待定
  • 覆蓋範圍: 統一帳戶現貨/正向合約/期權交易
  • 詳細內容: 您可以使用websocket來下改撤單

批量接口支持現貨交易​

  • 可用日期: 測試網 - 已上線, 主網 - 2024年3月5日
  • 覆蓋範圍: 統一帳戶現貨交易
  • 詳細內容: 您可以使用批量下改撤接口進行現貨交易

現貨支持雙向止盈止損​

  • 可用日期: 測試網 - 已上線, 主網 - 2024年1月15日
  • 覆蓋範圍: 統一帳戶現貨交易
  • 詳細內容: 您可以在創建現貨訂單時通過takeProfit, stopLoss設置市價止盈止損

現貨支持組合保證金對衝​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年11月16日
  • 覆蓋範圍: 統一帳戶的組合保證金模式
  • 詳細內容: 您可以通過這個設置現貨對衝接口啟用或關閉現貨對衝功能

現貨支持改單​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年11月1日
  • 覆蓋範圍: 經典帳戶和統一帳戶現貨
  • 詳細內容: 您可以通過這個改單接口對現貨訂單進行改單

統一帳戶現貨止盈止損單、條件單邏輯修改​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年10月26日 (按照uid尾號灰度期間, 全量預計11月2日)
  • 覆蓋範圍: 統一帳戶的現貨交易
  • 詳細內容: 當止盈止損單或者條件單觸發後, 訂單ID保持不變

UTA Pro支持批量下單​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年8月31日
  • 覆蓋範圍: UTA Pro帳戶: USDT永續, USDC永續 & USDC交割 (正向合約linear)
  • 詳細內容: UTA Pro帳戶能夠進行正向合約的批量下改撤
示例
POST https://api-testnet.bybit.com/v5/order/create-batch

> 請求體
{
    "category": "linear",
    "request": [
        {

            "symbol": "BTCUSDT",
            "orderType": "Limit",
            "side": "Buy",
            "qty": "0.1",
            "price": "25500",
            "timeInForce": "GTC",
            "orderLinkId": "test-03",
            "reduceOnly": false,
            "tpslMode": "Full",
            "takeProfit": "26300",
            "stopLoss": "24800",
            "triggerDirection": null,
            "triggerPrice": null,
            "triggerBy": null,
            "positioIdx": 0,
            "smpType": null,
            "tpLimitPrice": null,
            "slLimitPrice": null,
            "slOrderType": null,
            "tpOrderType": null

        },
        {

            "symbol": "ETHUSDT",
            "orderType": "Limit",
            "side": "Buy",
            "qty": "0.1",
            "price": "1550",
            "timeInForce": "GTC",
            "orderLinkId": "test-04",
            "reduceOnly": false,
            "tpslMode": "Full",
            "takeProfit": "1680",
            "stopLoss": "1490",
            "triggerDirection": null,
            "triggerPrice": null,
            "triggerBy": null,
            "positioIdx": 0,
            "smpType": null,
            "tpLimitPrice": null,
            "slLimitPrice": null,
            "slOrderType": null,
            "tpOrderType": null
        }
    ]
}
> 響應
{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "category": "linear",
                "symbol": "BTCUSDT",
                "orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14",
                "orderLinkId": "test-03",
                "createAt": "1693212677410"
            },
            {
                "category": "linear",
                "symbol": "ETHUSDT",
                "orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c",
                "orderLinkId": "test-04",
                "createAt": "1693212677410"
            }
        ]
    },
    "retExtInfo": {
        "list": [
            {
                "code": 0,
                "msg": "OK"
            },
            {
                "code": 0,
                "msg": "OK"
            }
        ]
    },
    "time": 1693212677411
}

增加WS私有連接可配置斷線時間​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年8月16日
  • 覆蓋範圍: 構建v5私有連接時可用該配置參數
  • 詳細內容: 構建連接時, 設置/v5/private?max_active_time=, 值可以是從30s到600s之間。當服務端與客戶端之間無上下行數據時, 當達到這個配置的時間間隔時, 服務端則會斷開連接 (並不完全準確, 因為當前ticker的輪訓時間是30秒)

調整錯誤碼​

舊錯誤碼新錯誤碼消息
34001283200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.
1760363200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.

UTA母子帳戶間共享借貸額度​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年8月11日
  • 覆蓋範圍: 統一帳戶
  • 詳細內容: 過去, 每個uta帳戶擁有獨自的借貸額度, 上線後, 該額度由母子之間共享

UTA用戶可以選擇保證金幣種是否進行抵押​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年8月10日
  • 覆蓋範圍: 統一帳戶
  • 詳細內容: UTA用戶可以選擇保證金幣種是否進行抵押通過該接口

用戶可以自主升級到UTA Pro​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年8月8日
  • 覆蓋範圍: 普通帳戶, 統一帳戶
  • 詳細內容: 用戶可以通過該接口升級至UTA Pro

OpenAPI支持現貨條件單​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年8月7日
  • 覆蓋範圍: 普通帳戶, 統一帳戶
  • 詳細內容: 用戶可以通過openAPI創建現貨條件單

UTA支持機構借貸​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年7月24日
  • 覆蓋範圍: 統一帳戶
  • 詳細內容: 統一帳戶支持機構借貸

USDC永續支持獲得資金費的數據​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年7月3日
  • 覆蓋範圍: 統一帳戶 USDC永續合約
  • 詳細內容: 查詢成交紀錄接口之前是沒有execType=Funding的且websocket個人成交不推送該數據. 現在您將會查詢到和獲得推送.

新版帶單交易​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年6月24日
  • 覆蓋範圍: 舊版帶單交易
  • 詳細內容: Bybit將會從6月24日開始陸續開放uid升級功能, 如果您選擇升級到新的帶單交易, 請注意老版本的Copy Trading V3接口將不可再用, 請直接使用合約 V3 或者 V5接口

統一帳戶支持逐倉保證金模式和雙倉模式​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年6月1日
  • 覆蓋範圍: 僅統一帳戶生效
  • 詳細內容: 統一帳戶的逐倉保證金是帳戶維度. 雙向持倉僅支持USDT永續

新版止盈止損​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年5月23日
  • 覆蓋範圍: V5 API 和 合約V3 API
  • 詳細內容: 統一帳戶(UTA): USDT 永續, USDC 永續 和 交割, 反向合約
    普通帳戶: USDT 永續, 反向合約

查詢升級前紀錄​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年4月27日
  • 覆蓋範圍: 統一交易帳戶
  • 詳細內容: 升級後，可以通過該接口查詢到升級之前的一些交易紀錄.

余幣寶 (廢棄)​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年4月22日
  • 覆蓋範圍: 所有用戶 (目前灰度階段)
  • 詳細內容: 您可以將閒置資金存入余幣寶來賺取收益

自成交攔截​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年4月20日
  • 覆蓋範圍: 請查看這裡
  • 詳細內容: 支持現貨、期貨和期權

支持持倉升級至UTA帳戶​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年4月4日
  • 覆蓋範圍: 普通帳戶升級至統一帳戶
  • 詳細內容: 升級時無需平倉. 更多細節，請查閱升級接口

統一交易帳戶支持USDC交割產品交易​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年3月20日
  • 覆蓋範圍: 僅限升級到UTA的帳戶
  • 詳細內容: V5接口將適用於UTA帳戶交易USDC交割

機構借貸V5接口​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年3月13日
  • 覆蓋範圍: 申請了場外借貸的機構用戶
  • 詳細內容: 可以查詢到帳戶的LTV, 借款及還款等信息

普通帳戶支持使用V5接口進行現貨交易​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年3月10日
  • 覆蓋範圍: 普通帳戶
  • 詳細內容: 使用V5交易現貨

統一交易對狀態枚舉​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年3月10日
  • 覆蓋範圍: /v5/market/instruments-info status字段
  • 詳細內容: 統一使用Trading, Closed, Settling, PreLaunch, Deliverying

上線全倉槓桿(普通帳戶)V5版本​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年3月3日
  • 覆蓋範圍: 普通帳戶能夠使用V5接口操作全倉槓桿
  • 詳細內容: 借貸、還款、查詢操作

UTA用戶支持交易反向合約​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年2月21日
  • 覆蓋範圍: UTA用戶能夠通過V5接口交易反向合約
  • 詳細內容: 請注意該反向合約交易是通過反向合約錢包(CONTRACT)完成

將現貨帳戶併入統一帳戶(重要)​

  • 可用日期: 預計3月3日当天執行
  • 覆蓋範圍: 僅UTA用戶
  • 詳細內容: 您需要修改提現邏輯，先將資金轉入資金帳戶，然後調用提現接口

使用RSA密鑰方式鑒權​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年2月21日
  • 覆蓋範圍: 所有V3、V5需要鑒權的接口
  • 詳細內容: 請參閱該引導完成快速上手

execType增加新的枚舉值​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年2月20日
  • 覆蓋範圍: 合約 V3 - Websocket私有頻道 - 個人成交
  • 詳細內容: 新增資金費用結算的推送，其中execType=Funding

V5接口支持普通帳戶​

  • 可用日期: 測試網 - 已上線, 主網 - 2023年2月9日
  • 覆蓋範圍: 普通帳戶支持交易 USDT永續 and 反向合約
  • 詳細內容: 此次發佈之後，如果您有以下行為，您可能會遭遇一些401錯誤或者404錯誤:

401: 您仍然在使用v1/v2的鑒權方式訪問V5接口：

GET https://api.bybit.com/v5/position/list?api_key=xxx&category=linear&recv_window=5000&symbol=ETHUSDT&timestamp=1675929695887&sign=xxx

您應該將鑒權參數放在請求頭當中:

Host: api-testnet.bybit.com
-H 'X-BAPI-SIGN: XXXXXXXXXX' \
-H 'X-BAPI-API-KEY: XXXXXXXXXX' \
-H 'X-BAPI-TIMESTAMP: 1658384431891' \
-H 'X-BAPI-RECV-WINDOW: 5000'

404: 對於以下接口，如果您傳入不恰當的category值, 比如, 您是普通帳戶，但category傳入了option/spot

調整錯誤碼​

舊錯誤碼新錯誤碼消息
3400045110073Set margin mode failed
34009910016Server error

增加500檔的推送​

  • 可用日期: 測試網 - 2023年1月13日, 主網 - 2023年1月16日
  • 覆蓋範圍: V5 深度 和 V3 深度
  • 詳細內容: 期貨的正反向合約將支持500檔深度的推送, 其中推送頻率為100ms.