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,OnChain
Remarks: currently, only flexible savings and OnChain 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
    > swapOrderValuestringSwap order value. Only for LST Onchain.
    > estimateRedeemTimestringEstimate redeem time, in milliseconds. Only for Onchain
    > estimateStakeTimestringEstimate stake time, in milliseconds. Only for Onchain

    Request Example

    GET /v5/earn/order?orderId=9640dc23-df1a-448a-ad24-e1a48028a51f&category=OnChain 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": "1",
    "orderType": "Stake",
    "orderId": "9640dc23-df1a-448a-ad24-e1a48028a51f",
    "orderLinkId": "cjm2",
    "status": "Success",
    "createdAt": "1744166831000",
    "productId": "8",
    "updatedAt": "1744166832000",
    "swapOrderValue": "",
    "estimateRedeemTime": "",
    "estimateStakeTime": ""
    }
    ]
    },
    "retExtInfo": {},
    "time": 1739937045520
    }