# 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 代币类型