查詢質押/贖回訂單歷史

信息

API key需要"理財""權限

HTTP 請求

GET /v5/earn/order

請求參數

參數	是否必需	類型	說明
category	true	string	FlexibleSaving 備註: 本期僅支持活期理財
orderId	false	string	系統生成的訂單ID orderId和orderLinkId二者必須傳其一 如果都傳入, 確保二者是來自同一筆訂單, 否則返回空
orderLinkId	false	string	自定義訂單ID 備註: 如果orderLinkId有復用, 則僅用orderLinkId查詢時, 總是返回最近的那筆訂單

響應參數

參數	類型	說明
list	array	Object
> coin	string	幣種名稱
> orderValue	string	質押/贖回數量
> orderType	string	Redeem, Stake
> orderId	string	系統生成的訂單ID
> orderLinkId	string	自定義訂單ID
> status	string	訂單狀態 Success, Fail, Pending
> createdAt	string	訂單創建時間 (毫秒)
> productId	string	產品ID
> updatedAt	string	訂單更新時間 (毫秒)

請求示例

HTTP

GET /v5/earn/order?orderId=0572b030-6a0b-423f-88c4-b6ce31c0c82d&category=FlexibleSaving HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1739937044221
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_stake_or_redemption_history(
    category="FlexibleSaving",
    orderId="0572b030-6a0b-423f-88c4-b6ce31c0c82d",
))

Node.js

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "list": [
            {
                "coin": "BTC",
                "orderValue": "0.35",
                "orderType": "Redeem",
                "orderId": "0572b030-6a0b-423f-88c4-b6ce31c0c82d",
                "orderLinkId": "btc-earn-001",
                "status": "Success",
                "createdAt": "1739936607000",
                "productId": "430",
                "updatedAt": "1739936607000"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1739937045520
}