# 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) |