# 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 |