# 5、Query Order Details

Request Method

  • POST

URL

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

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's 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 signature algorithm kAXyh+eerqrefyaF8dyFB0M4FVo=

The above parameters are all passed as HTTP headers.

Request Body Example:

{
   "orderId":"OEXCHEXCH202505140726581747207618009-U0000000401298864",
}

Parameter Explanation:

Parameter Name Type Required Description
orderId String Yes Order ID

Response Type:

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

Successful Response Example (HTTP 200):

{
  "code":"200",
  "success":true,
  "msg":"成功",
  "msgEn":"SUCCESS",
  "data":{
    "orderId":"OEXCHEXCH202505140726581747207618009-U0000000401298864",
    "exSymbolType":602,
    "currencyType":"BRL",
    "chainType":"BSC",
    "tokenType":"USDT",
    "tokenAmount":"1.121385",
    "exchangeRate":"5.944444",
    "currencyAmount":"6.67",
    "orderStatus":8,
    "orderFee":"0.0224277",
    "orderEntryAmount":"1.0989573",
    "orderTime":1747207618000,
    "orderCompleteTime":1747207634000,
    "flowInfoList":[
      {
        "orderStatus":1,
        "createTime":1747207618074,
        "relevanceOrderId":"OCURRPAID202505140726581747207618082-U0000000401298865"
      },
      {
        "orderStatus":2,
        "createTime":1747207621013,
        "relevanceOrderId":"OCRYPDRAW202505140727011747207621671-U0000000401298868"
      },
      {
        "orderStatus":8,
        "createTime":1747207634232,
        "relevanceOrderId":""
      }],
    "currencyRelevanceOrderId":"OCURRPAID202505140726581747207618082-U0000000401298865",
    "cryptoRelevanceOrderId":"OCRYPDRAW202505140727011747207621671-U0000000401298868",
    "addressTo":"0xa86324347583F783a169CC9F5449e23460295E8",
    "hash":"0x3a0ce674e93f43cc03a0630d45c1a9599241fa86e8e57be382a132313978b",
    "fromAddress":"",
    "toAddress":"0xa8666442fA7583F783a169CC9F5449ec6603333395E8",
    "userInfoType":"",
    "userInfoName":"",
    "userInfoNo":"",
    "accountType":"",
    "accountName":"",
    "accountCode":"",
    "accountNo":"",
    "payParam":"",
    "currencyPayType":"",
    "currencyPayoutType":"",
    "voucher":{
      "data":""
    }
  }
}

Response Parameter Explanation:

Parameter Name Type Description
orderId String Order ID
exSymbolType Int64 Transaction type
currencyType String Fiat currency type
chainType String Blockchain type
tokenType String Token type
tokenAmount String Token amount
exchangeRate String Exchange rate
currencyAmount String Fiat currency amount
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
orderFee String Transaction fee
orderEntryAmount String Amount received at entry
orderTime Int64 Order creation time
orderCompleteTime Int64 Order completion time
currencyRelevanceOrderId String Related fiat order ID
cryptoRelevanceOrderId String Related cryptocurrency order ID
addressTo String Receiving wallet address
hash String Hash
fromAddress String Payer's wallet address
toAddress String Payment wallet address
userInfoType String User information type (check for empty)
userInfoName String User's name (check for empty)
userInfoNo String User's ID (check for empty)
accountType String Account type (check for empty)
accountName String Account name (check for empty)
accountNo String Account number (check for empty)
accountCode String Account code (check for empty)
payParam String Payment parameters (check for empty)
currencyPayType String Currency payment type (check for empty)
currencyPayoutType String Currency payout type (check for empty)

flowInfoList:

Parameter Name Type Description
createTime Int64 Flow time
orderStatus Int64 Flow status
relevanceOrderId String Related order ID

voucher

Parameter Name Type Description
data String Voucher link (check for empty)