跳至主要内容

複利再投

信息
  • 需要身份驗證。每個 UID 每秒最多 5 次請求。API 金鑰需要具備 Earn(理財)權限。
  • 將指定持倉的可領取收益再投入流動性池。
  • 訂單為非同步處理。成功響應表示訂單已被接受。請使用查詢訂單資訊追蹤訂單狀態。
  • orderLinkId 提供冪等性保障——30 分鐘內提交相同 orderLinkId 將返回相同 orderId,不會建立重複訂單。
  • 每個持倉同一時間只允許存在一筆待處理訂單。

HTTP 請求

POST/v5/earn/liquidity-mining/reinvest

請求參數

參數必填類型說明
productIdtruestring產品 ID
orderLinkIdtruestring用戶自定義訂單 ID(最多 36 個字元),用於冪等性控制
positionIdtruestring要執行再投資的持倉 ID。可從查詢持倉資訊獲取

響應參數

參數類型說明
orderIdstring系統生成的訂單 ID
orderLinkIdstring用戶自定義訂單 ID

請求示例

POST /v5/earn/liquidity-mining/reinvest 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": "5",
"orderLinkId": "lm-reinvest-01",
"positionId": "1498"
}

響應示例

{
"retCode": 0,
"retMsg": "",
"result": {
"orderId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"orderLinkId": "lm-reinvest-01"
},
"retExtInfo": {},
"time": 1741651200000
}