# 4、Query Order List

Request Method

  • POST

URL

/api/v1/exchange/express/query/order/list

Content-Type

Content-Type: application/json; charset=utf-8

Request Header Parameters

Param Type Description Sample
access_key String Access key obtained from the merchant backend pFqV75X3
timestamp int64 Unix timestamp in milliseconds (13 digits) 1679724896223
nonce String UUID V4 random string 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String Signature calculated via the signing algorithm kAXyh+eerqrefyaF8dyFB0M4FVo=

All of the above parameters should be passed as HTTP headers.

Request Body Example:

{
     "page": 1,
     "size": 10,
     "orderId": "",
     "exSymbolType": "601",
     "createTimeStart": "2025-05-13T16:00:00Z",
     "createTimeEnd": "2025-05-21T15:59:59Z",
     "completeTimeStart": "2025-05-18T16:00:00Z",
     "completeTimeEnd": "2025-05-21T15:59:59Z"
}

Parameter Description:

Parameter Name Type Required Description
orderId String No Order number
exSymbolType String No Order type (601 for withdrawal, 602 for deposit)
createTimeStart String No Order creation start time
createTimeEnd String No Order creation end time
completeTimeStart String No Completion start time
completeTimeEnd String No Completion end time
page Int64 No Page number, default is page 1
size Int64 No Number of records per page, default is 1000

Response Type:

Header: { 'Content-Type': 'application/json;charset=utf-8'}

Successful Response Example (HTTP 200):

{
  "code":"200",
  "success":true,
  "msg":"成功",
  "msgEn":"SUCCESS",
  "data":{
    "page":1,
    "pageSize":10,
    "total":7,
    "totalPages":0,
    "hasMore":false,
    "items":[
      {
        "orderId":"OEXCHEXCH202505200654571747724097229HAMBIT-U0000000401299024",
        "exSymbolType":601,
        "currencyType":"BRL",
        "chainType":"BSC",
        "tokenType":"USDT",
        "tokenAmount":"1",
        "exchangeRate":"5.611",
        "currencyAmount":"5.61",
        "orderStatus":8,
        "orderFee":"0.12",
        "orderEntryAmount":"5.49",
        "orderTime":1747724097000,
        "orderCompleteTime":1747724134000
      }],
  }
}

Response Parameter Description

Parameter Name Type Description
chainType String Chain type
currencyAmount String Fiat currency amount
currencyType String Fiat currency type
exSymbolType Int64 Transaction type
exchangeRate String Exchange rate
orderCompleteTime String Order completion time
orderEntryAmount String Actual received amount
orderFee String Transaction fee
orderId String Order number
orderStatus Int64 Order Status 1 Pending Fiat Payment 2 Fiat Payment Received 4 Crypto Collection Pending 8 Exchange Completed 32 Exchange Failed 64 Crypto Received
orderTime Int64 Order creation time
tokenAmount String Token amount
tokenType String Token type