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