# 4、查询订单列表
请求方式
- POST
URL:
/api/v1/exchange/express/query/order/list
Content-Type:
Content-Type: application/json; charset=utf-8
请求头参数(Header)
Param | Type | Description | Sample |
---|---|---|---|
access_key | String | 商户后台获取的访问密钥 | pFqV75X3 |
timestamp | int64 | Unix 毫秒时间戳(13 位) | 1679724896223 |
nonce | String | UUID V4 随机字符串 | 794c26b0-d33c-4394-b2bb-c485eca16d9e |
sign | String | 通过签名算法计算的签名 | kAXyh+eerqrefyaF8dyFB0M4FVo= |
上述参数全部作为 HTTP Header 传入
请求体数据示例:
{
"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"
}
参数说明:
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
orderId | String | 否 | 订单号 |
exSymbolType | String | 否 | 订单类型 601出金 602 入金 |
createTimeStart | String | 否 | 创建订单时间开始 |
createTimeEnd | String | 否 | 创建订单时间结束 |
completeTimeStart | String | 否 | 完成时间开始 |
completeTimeEnd | String | 否 | 完成时间结束 |
page | Int64 | 否 | 页数 默认1页 |
size | Int64 | 否 | 条数 默认1000条 |
响应类型:
Header: { 'Content-Type': 'application/json;charset=utf-8'}
响应说明:
正常响应数据示例(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
}],
}
}
响应参数说明
参数名 | 类型 | 描述 |
---|---|---|
chainType | String | 链类型 |
currencyAmount | String | 法币金额 |
currencyType | String | 法币币种 |
exSymbolType | Int64 | 交易类型 |
exchangeRate | String | 兑换价格 |
orderCompleteTime | String | 订单完成时间 |
orderEntryAmount | String | 实际收到金额 |
orderFee | String | 手续费 |
orderId | String | 订单号 |
orderStatus | Int64 | 订单状态 1 待支付法币 2 收到法币 4 代收加密币 8 兑换完成 32 兑换失败 64 已收加密货币 |
orderTime | Int64 | 订单创建时间 |
tokenAmount | String | 交易代币数量 |
tokenType | String | 代币类型 |