Skip to main content

Get Stake/Redeem Order History

info

API key needs "Earn" permission

HTTP Request

GET /v5/earn/order

Request Parameters

ParameterRequiredTypeComments
categorytruestringFlexibleSaving
Remarks: currently, only flexible savings is supported
orderIdfalsestringOrder ID
  • either orderId or orderLinkId is required
  • if both are passed, make sure they're matched, otherwise returning empty result
  • orderLinkIdfalsestringOrder link ID
    Remarks: Always return the latest one if order link id is ever reused when querying by orderLinkId only

    Response Parameters

    ParameterTypeComments
    listarrayObject
    > coinstringCoin name
    > orderValuestringamount
    > orderTypestringRedeem, Stake
    > orderIdstringOrder ID
    > orderLinkIdstringOrder link ID
    > statusstringOrder status Success, Fail, Pending
    > createdAtstringOrder created time, in milliseconds
    > productIdstringProduct ID
    > updatedAtstringOrder updated time, in milliseconds

    Request Example

    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

    Response Example

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