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