查询钱包交易记录明细¶
如果您按订单ID筛选交易但返回为空,可能是因为该订单尚未完成。只有状态为 FINISHED 或 PARTIALLY_FAILED 的订单才会包含交易哈希(tx_id);其他状态的订单不包含交易哈希。
推荐步骤¶
GET 订单详情 API(检查 order_no)¶
检查订单详情以查找 order_no 和当前订单状态。
订单状态是否为 FINISHED 或 PARTIALLY_FAILED?¶
- 是 → 继续下一步请求交易详情。
- 否 → 跳过交易详情请求(没有可用的 tx_id)。
GET 交易详情 API(b_id、wallet_code 等)¶
使用相关的路径和查询参数调用交易详情接口。
查看交易数据¶
检查返回的交易记录和详情。
请求¶
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| b_id 必填 | Long | 业务线ID |
| wallet_code 必填 | String | 钱包ID |
查询参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| coin_name 可选 | String | 资产名称 允许值:参考支持的代币中的 Coin Name (API) 列 |
| tx_types 可选 | String[] | 交易类型 |
| addresses 可选 | String[] | 地址 |
| id 可选 | String | 钱包详情项ID |
| tx_id 可选 | String | 交易哈希 |
| order_no 可选 | String | 订单ID |
| offset 可选 | Integer | 默认:0 |
| limit 可选 | Integer | 默认:10 |
| create_time_order 可选 | Integer | 按创建时间排序:
|
| start_time 可选 | Long | 起始时间戳 (默认:0) |
| end_time 可选 | Long | 结束时间戳 (默认:当前时间) |
响应¶
响应体¶
| 字段 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应代码(0 = 成功) |
| message | String | 响应消息 |
| successful | Boolean | 请求是否成功 |
| data | Object | 详见下方 data 对象详情 |
data (对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| offset | Integer | 偏移量 |
| limit | Integer | 限制条数 |
| total | Integer | 记录总数 |
| list | Object[] | 交易详情记录列表(详见下方 list 对象详情) |
list (对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| id | String | 记录ID |
| domain_id | String | 企业ID |
| wallet_code | String | 钱包ID |
| chain | String | 链名称 |
| wallet_type | String | 钱包类型 允许值: MIXED_ADDRESS, SEGREGATED_ADDRESS |
| storage_type | String | 存储类型 允许值: PRIME_HOT, PRIME_COLD, ENTERPRISE_HOT, ENTERPRISE_COLD |
| wallet_name | String | 钱包名称 |
| coin_name | String | 资产名称 |
| full_name | String | 待确认 |
| order_no | String | 订单ID |
| order_type | String | 表示订单类型:入账或提币 |
| block_height | Long | 区块高度 |
| confirm_ratio | String | 确认比例 |
| tx_id | String | 交易哈希 |
| tx_size | Long | 交易大小 (默认:1) |
| tx_type | String | 交易类型。 允许值:完整列表及描述请参阅交易类型。 |
| withdraw_amount | Decimal | 提币金额 |
| withdraw_amount_str | String | 提币金额(字符串格式) |
| gas_price | Decimal | Gas价格(ETH系列) |
| gas_price_str | String | Gas价格(ETH系列)(字符串格式) |
| gas_limit | Decimal | Gas限制(ETH系列) |
| gas_limit_str | String | Gas限制(ETH系列)(字符串格式) |
| tx_fee | Decimal | 交易手续费 |
| tx_fee_str | String | 交易手续费(字符串格式) |
| tx_fee_rate | Decimal | 交易手续费率(提币) |
| tx_fee_rate_str | String | 交易手续费率(提币)(字符串格式) |
| tx_fee_type | String | 交易手续费类型(提币) |
| miner_reward | Decimal | 区块奖励(入账) |
| miner_reward_str | String | 区块奖励(入账)(字符串格式) |
| miner_fee | Decimal | 矿工费奖励(入账) |
| miner_fee_str | String | 矿工费奖励(入账)(字符串格式) |
| deposit_amount | Decimal | 入账总额 |
| deposit_amount_str | String | 入账总额(字符串格式) |
| wallet_balance | Decimal | 钱包余额 |
| wallet_balance_str | String | 钱包余额(字符串格式) |
| tx_status | String | 交易状态 允许值: unconfirmed, confirmed, failed, frozen, rollbacked, unconfirmed_alarm |
| remark_detail | String | 备注 |
| tx_time_stamp | Long | 交易时间戳 |
| create_time_stamp | Long | 创建时间戳 |
| tr_id | String | 旅行规则ID |
| contract_address | String | 所选代币的合约地址。该值对应于代币列表中的 智能合约字段。 |
| token_id | String | 仅在交易涉及 NFT 时返回;否则返回 null。 |
| bid | String | 业务线ID |
| vins | Object[] | 输入交易列表(VINs) |
| vouts | Object[] | 输出交易列表(VOUTs) |
vins (对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| address | String | VIN地址 |
| token_address | String | VIN 交易的代币地址 |
| idx | String | VIN ID |
| tag | String | VIN备注 |
| amount | Decimal | VIN金额 |
| amount_str | String | VIN金额(字符串格式) |
| balance | Decimal | 交易后余额 |
| balance_str | String | 交易后余额(字符串格式) |
| is_change | Long | 是否为找零 |
| desc | String | VIN描述 |
| mark | String | 该标识字段目前仅用于 ADA(Cardano)代币交易,用于指示地址是否为备用(预备)地址。 当适用时,该字段返回 prefund_address;否则返回 null。 |
| muxed_id | String | 嵌入在 Stellar 多路复用地址中的 64 位整数 ID。用于在同一 Stellar 公钥下标识特定的子用户或子业务。仅适用于 Stellar (XLM) 交易;否则返回 null。 |
| muxed | String | Stellar 多路复用地址(以 M 开头)。这是标准 Stellar 公钥(以 G 开头)与 64 位 ID 的编码组合,用于区分同一账户下的不同子用户或子业务。仅适用于 Stellar (XLM) 交易;否则返回 null。 |
vouts (对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| address | String | VOUT地址 |
| token_address | String | VOUT 交易的代币地址 |
| idx | String | VOUT ID |
| tag | String | VOUT备注 |
| amount | Decimal | VOUT金额 |
| amount_str | String | VOUT金额(字符串格式) |
| balance | Decimal | 交易后余额 |
| balance_str | String | 交易后余额(字符串格式) |
| is_change | Integer | 是否为找零 |
| desc | String | VOUT描述 |
| mark | String | 该标识字段目前仅用于 ADA(Cardano)代币交易,用于指示地址是否为备用(预备)地址。 当适用时,该字段返回 prefund_address;否则返回 null。 |
| muxed_id | String | 嵌入在 Stellar 多路复用地址中的 64 位整数 ID。用于在同一 Stellar 公钥下标识特定的子用户或子业务。仅适用于 Stellar (XLM) 交易;否则返回 null。 |
| muxed | String | Stellar 多路复用地址(以 M 开头)。这是标准 Stellar 公钥(以 G 开头)与 64 位 ID 的编码组合,用于区分同一账户下的不同子用户或子业务。仅适用于 Stellar (XLM) 交易;否则返回 null。 |
响应示例¶
{
"code": 0,
"message": "",
"data": {
"offset": 0,
"limit": 10,
"list": [
{
"id": 7340805,
"domain_id": "1e2fa188f5d44faca64c45485062e829",
"wallet_code": "CHEVMS5368231134",
"chain": "ETH",
"wallet_type": "MIXED_ADDRESS",
"storage_type": "PRIME_HOT",
"wallet_name": "wew",
"coin_name": "ETH",
"full_name": null,
"order_no": "C6118000085",
"order_type": "WITHDRAW",
"block_height": 2014240,
"confirm_ratio": null,
"tx_id": "0x531c3825f9628809fb0b115cdfc8169eb79823fd7132939d940e8c713d5e8115",
"tx_size": 1,
"tx_type": "FEE_PAYMENT",
"withdraw_amount": 0,
"withdraw_amount_str": "0",
"gas_price": 10018,
"gas_price_str": "10018",
"gas_limit": 75847,
"gas_limit_str": "75847",
"tx_fee": 461769692,
"tx_fee_str": "461769692",
"tx_fee_rate": null,
"tx_fee_rate_str": null,
"tx_fee_type": "ETH",
"miner_reward": null,
"miner_reward_str": null,
"miner_fee": null,
"miner_fee_str": null,
"deposit_amount": null,
"deposit_amount_str": null,
"wallet_balance": 10066611279647616,
"wallet_balance_str": "10066611279647616",
"tx_status": "confirmed",
"remark_detail": null,
"vins": [
{
"address": "0x2BF4714e26895d77f72d732120C45d4125bBbCe8",
"token_address": null,
"idx": null,
"tag": null,
"amount": 461769692,
"amount_str": "461769692",
"balance": 10811396063308,
"balance_str": "10811396063308",
"is_change": 0,
"desc": null,
"mark": null,
"muxed_id": null,
"muxed": null
}
],
"vouts": [],
"tx_time_stamp": 1768189044000,
"create_time_stamp": 1768189203000,
"tr_id": null,
"contract_address": null,
"token_id": null,
"bid": "b4a25892d06542ba8fedb40e99d0c659"
}
],
"total": 1
},
"successful": true
}