跳至主要内容

查詢質押/贖回訂單歷史

信息

API key需要"理財""權限

HTTP 請求

GET /v5/earn/order

請求參數

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

    響應參數

    參數類型說明
    listarrayObject
    > coinstring幣種名稱
    > orderValuestring質押/贖回數量
    > orderTypestringRedeem, Stake
    > orderIdstring系統生成的訂單ID
    > orderLinkIdstring自定義訂單ID
    > statusstring訂單狀態 Success, Fail, Pending
    > createdAtstring訂單創建時間 (毫秒)
    > productIdstring產品ID
    > updatedAtstring訂單更新時間 (毫秒)

    請求示例

    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

    響應示例

    {
    "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
    }