移倉

您可以在同一個母子帳戶體系下移動期貨、期權的倉位, 以及現貨的幣幣交易

統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 現貨 / 期權

信息

• 該接口僅支持母帳戶的api key訪問
• 移倉間的UID和調用者的UID必須是同一個母子帳戶體系
• 該移倉生成的交易將不會出現在公有行情的成交中(包括Rest API和Websocket)
• 該操作不會產生手續費
• fromUid 和 toUid都必須是統一交易帳戶, 並且對於期貨而言, 倉位需要處於單向模式下
• 請注意一旦成交, 查詢成交紀錄, 查詢平倉盈虧, 以及私有推送成交會返回execType=MovePosition的數據

HTTP 請求

POST /v5/position/move-positions

請求參數

參數	是否必需	類型	說明
fromUid	true	string	原UID 必須是統一交易帳戶 期貨倉位必須有處於單向持倉模式
toUid	true	string	目標UID 必須是統一交易帳戶 期貨倉位必須有處於單向持倉模式
list	true	array	Object. 單次請求最多支持25腿
> category	true	string	產品類型. linear, spot, option
> symbol	true	string	合約名稱/幣對名
> price	true	string	訂單價格 linear: 價格需要位於[95% 標記價格, 105% 標記價格]之間 spot和option: 價格需要遵循查詢可交易產品的規格信息的價格上下限和精度
> side	true	string	是fromUid的交易方向 例如, fromUid持有多倉, 如果選擇side=Sell, 則執行後, fromUid的多倉會被減倉或者開了空倉取決於qty的大小
> qty	true	string	交易數量 該數字需要滿足查詢可交易產品的規格信息的qty規則, 特別的, 對於linear, 可以支持5倍的maxOrderQty

響應參數

參數	類型	說明
retCode	integer	響應碼. 0表示請求被成功接受
retMsg	string	響應信息
result	map	Object
> blockTradeId	string	大宗交易訂單ID
> status	string	訂單狀態. Processing, Rejected
> rejectParty	string	""表示初始校驗通過, 需要進一步通過查詢移倉歷史接口來確認最終狀態 Taker, Maker: 當status=Rejected返回 bybit表示處理過程中的錯誤發生在Bybit側

請求示例

HTTP

POST /v5/position/move-positions HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1697447928051
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "fromUid": "100307601",
    "toUid": "592324",
    "list": [
        {
            "category": "spot",
            "symbol": "BTCUSDT",
            "price": "100",
            "side": "Sell",
            "qty": "0.01"
        }
    ]
}

Python

Java

import com.bybit.api.client.domain.*;
import com.bybit.api.client.domain.position.*;
import com.bybit.api.client.domain.position.request.*;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance().newAsyncPositionRestClient();
var movePositionsRequest = Arrays.asList(MovePositionDetailsRequest.builder().category(CategoryType.SPOT.getCategoryTypeId()).symbol("BTCUSDT").side(Side.SELL.getTransactionSide()).price("100").qty("0.01").build(),
                MovePositionDetailsRequest.builder().category(CategoryType.SPOT.getCategoryTypeId()).symbol("ETHUSDT").side(Side.SELL.getTransactionSide()).price("100").qty("0.01").build());
var batchMovePositionsRequest = BatchMovePositionRequest.builder().fromUid("123456").toUid("456789").list(movePositionsRequest).build();
System.out.println(client.batchMovePositions(batchMovePositionsRequest));

Node.js

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "blockTradeId": "e9bb926c95f54cf1ba3e315a58b8597b",
        "status": "Processing",
        "rejectParty": ""
    }
}