質押/贖回

信息

API key需要"理財""權限

備註

在極端情況下，當相應代幣的市場需求極高，本金贖回可能會出現延遲，預計需要 48 小時處理完畢。鏈上賺幣產品的贖回可能需要幾天的時間才能完成。一旦發動贖回請求，不能被取消。

HTTP 請求

POST /v5/earn/place-order

請求參數

參數	是否必需	類型	說明
category	true	string	FlexibleSaving,OnChain 備註: 本期僅支持活期理財和鏈上賺幣
orderType	true	string	訂單類型 Stake, Redeem
accountType	true	string	選擇帳戶類型 FUND, UNIFIED. OnChain 只支持FUND
amount	true	string	質押數量需要滿足最小/最大質押額 質押和贖回需要滿足幣種精度要求
coin	true	string	幣種名稱
productId	true	string	產品ID
orderLinkId	true	string	自定義訂單號, 同時用於冪等校驗 支持最長36位字符 30分鐘內無法使用相同的orderLinkId
redeemPositionId	false	string	用戶需要贖回的持倉ID：只有非LST 產品需要在贖回時傳

響應參數

參數	類型	說明
orderId	string	Order ID
orderLinkId	string	Order link ID

請求示例

HTTP

POST /v5/earn/place-order HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1739936605822
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 190

{
    "category": "FlexibleSaving",
    "orderType": "Redeem",
    "accountType": "FUND",
    "amount": "0.35",
    "coin": "BTC",
    "productId": "430",
    "orderLinkId": "btc-earn-001"
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.stake_or_redeem(
    category="FlexibleSaving",
    orderType="Redeem",
    accountType="FUND",
    amount="0.35",
    coin="BTC",
    productId="430",
    orderLinkId="btc-earn-001"
))

Node.js

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "orderId": "0572b030-6a0b-423f-88c4-b6ce31c0c82d",
        "orderLinkId": "btc-earn-001"
    },
    "retExtInfo": {},
    "time": 1739936607117
}