6、Query for Transfer Orders

Request Method

• POST

Request URL

/api/v3/wallet/query/transfer

Request Header

Content-Type: application/json;charset=utf-8

Request Header Parameters

Parameter	Type	Description	Example Value
access_key	String	Merchant backend access key	pFqV75X3
timestamp	int64	13-digit timestamp (milliseconds)	1679724896223
nonce	String	Random string (UUID V4)	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	Signature generated using a secret key	kAXyh+eerqrefyaF8dyFB0M4FVo=

Request Parameters (JSON)

{
  "externalOrderId": "622257420681202921",
  "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109"
}

Parameter	Type	Description	Required
externalOrderId	String	Merchant's order number (up to 64 characters)	✅ Yes
orderId	String	System's order number	✅ Yes

Response Type

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

Response Example

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [{
    "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109",
    "cashierId": "",
    "orderType": 2,
    "orderResourceType": 1,
    "userId": "1663371399710216194",
    "orderStatus": 1,
    "orderTime": 1690794160000,
    "externalOrderId": "622257420681202921",
    "orderAmount": "1",
    "orderActualAmount": "1.01",
    "orderFee": "0.01",
    "currencyType": "USD",
    "tokenType": "USDT",
    "chainType": "ETH",
    "exchangeRate": "0.983",
    "addressTo": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
    "tradeHash": "0xe9d043c9cbdb96ed7a71c5a0923baabe9e23316b3f1b0a01975bcd6d69b41fa3",
    "orderTypeCode": "Transfer",
    "orderResourceTypeCode": "Crypto",
    "orderStatusCode": "Accepted"
  }]
}

Response Parameter Descriptions

Parameter Name	Type	Description
orderId	String	Platform order ID
orderType	int64	Order type (2 = payment)
orderResourceType	int64	Business type (1 = crypto order)
userId	String	User ID
orderStatus	int64	Order status code
orderTime	int64	Order creation time (Unix milliseconds)
externalOrderId	String	Merchant order number
orderAmount	String	Original order amount
orderActualAmount	String	Actual payment amount
orderFee	String	Order fee
currencyType	String	Fiat currency type (e.g., USD)
tokenType	String	Crypto token type (e.g., USDT)
chainType	String	Blockchain type (e.g., ETH)
exchangeRate	String	Exchange rate
addressTo	String	Receiving address
tradeHash	String	Blockchain transaction hash
orderTypeCode	String	Order type description (e.g., Transfer)
orderResourceTypeCode	String	Business type description (e.g., Crypto)
orderStatusCode	String	Order status text (e.g., Accepted)
errorMsg	String	Error message
errorMsgEn	String	Error message (in English)