# 2、Query Wallet Address Details

Request Method

  • POST

Request URL

/api/v3/wallet/query/address/detail

Request Header

Content-Type: application/json;charset=utf-8
Parameter Name Type Description Example Value
access_key String Merchant backend obtained 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 the key kAXyh+eerqrefyaF8dyFB0M4FVo=

Request Parameters (JSON)

{
  "addressTo": "TAoW8YQhJFtoQKZxyNBB6GtRuay3BP2tQW",
  "startTime":"2025-04-17T16:00:00Z",
  "endTime":"2025-04-18T15:59:59Z",
}

Parameter Descriptions

Parameter Name Type Description Required
addressTo String Receiving wallet address (TRON/ETH/BSC, etc.) ✅ Yes
startTime String Query start time (UTC timezone) ✅ Yes
endTime String Query end time (UTC timezone) ✅ Yes

Response Type

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

Response Example

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [
    {
      "orderId": "OCRYPPAID202311031003401699005820300DEV001OO0000000400001022",
      "cashierId": "",
      "orderType": 1,
      "orderResourceType": 1,
      "userId": "1719629264270237698",
      "orderStatus": 4,
      "orderTime": 1699005820000,
      "externalOrderId": "",
      "orderAmount": "12",
      "orderActualAmount": "12",
      "orderEntryAmount": "11",
      "orderFee": "1",
      "orderPayTime": 1699005820000,
      "orderCompleteTime": 1699005820000,
      "currencyType": "USD",
      "tokenType": "USDT",
      "chainType": "TRON",
      "exchangeRate": "0.991",
      "addressFrom": "TBoG3wMvQhFUYQdcrHF6M3s7TKNHvCdW4w",
      "addressTo": "TAoW8YQhJFtoQKZxyNBB6GtRuay3BP2tQW",
      "tradeHash": "ff085ab75fc8edcb2a12142531f3c6442888cde94dce44bc1da41b361bb2e0e3",
      "orderTypeCode": "Pay",
      "orderResourceTypeCode": "Crypto",
      "orderStatusCode": "Completed"
    }
  ]
}

Response Parameter Descriptions

Parameter Name Type Description
orderId String Order ID
cashierId String Cashier ID
orderType int Order type (1 - Collection)
orderResourceType int Business type (1 - Crypto Order)
userId String User ID who initiated the order
orderStatus int Order status (1 - Pending payment, 2 - Chain confirmation, 4 - Completed, 8 - Payment amount mismatch, 16 - Timeout collection, 32 - Not paid)
orderTime int64 Order creation time (milliseconds timestamp)
externalOrderId String Merchant order ID
orderAmount String Original order amount
orderActualAmount String Actual received amount
orderEntryAmount String Amount to be credited to the merchant (= actual amount - fee)
orderFee String Fee amount
orderPayTime int64 Payment time (milliseconds timestamp)
orderCompleteTime int64 Completion time (milliseconds timestamp)
currencyType String Fiat currency type (e.g., USD)
tokenType String Crypto token type (e.g., USDT)
chainType String Main chain type (e.g., TRON, ETH)
exchangeRate String Exchange rate at the time of order creation
addressFrom String Sender address
addressTo String Receiver address
tradeHash String Blockchain transaction hash
orderTypeCode String Order type description (e.g., Pay)
orderResourceTypeCode String Business type description (e.g., Crypto)
orderStatusCode String Status description (e.g., Completed)