移除流動性

信息

• 需要身份驗證。每個 UID 每秒最多 5 次請求。API 金鑰需要具備 Earn（理財）權限。
• 訂單為非同步處理。成功響應表示訂單已被接受，而非已完成。請使用查詢訂單資訊追蹤訂單狀態。
• orderLinkId 提供冪等性保障——30 分鐘內提交相同 orderLinkId 將返回相同 orderId，不會建立重複訂單。
• 每個持倉同一時間只允許存在一筆待處理訂單。

HTTP 請求

POST/v5/earn/liquidity-mining/remove-liquidity

請求參數

參數	必填	類型	說明
productId	true	string	產品 ID
orderLinkId	true	string	用戶自定義訂單 ID（最多 36 個字元），用於冪等性控制
positionId	true	string	要移除流動性的持倉 ID。可從查詢持倉資訊獲取
removeRate	false	integer	提取百分比（整數，1–100）。不提供或設為 0 時預設為 100（全額提取）
removeType	false	string	提取模式：Normal（預設，按比例返還兩種幣種）、SingleQuoteCoin（僅返還計價幣種）、SingleBaseCoin（僅返還基礎幣種）

響應參數

參數	類型	說明
orderId	string	系統生成的訂單 ID
orderLinkId	string	用戶自定義訂單 ID

---

請求示例

POST /v5/earn/liquidity-mining/remove-liquidity HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741651200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "productId": "1001",
    "orderLinkId": "lm-remove-001-20260312",
    "positionId": "5001",
    "removeRate": 50,
    "removeType": "Normal"
}

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "orderId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "orderLinkId": "lm-remove-001-20260312"
    },
    "retExtInfo": {},
    "time": 1741651200000
}