跳转至

查询钱包交易记录明细

如果您按订单ID筛选交易但返回为空,可能是因为该订单尚未完成。只有状态为 FINISHED 或 PARTIALLY_FAILED 的订单才会包含交易哈希(tx_id);其他状态的订单不包含交易哈希。

推荐步骤

GET 订单详情 API(检查 order_no)

检查订单详情以查找 order_no 和当前订单状态。

订单状态是否为 FINISHED 或 PARTIALLY_FAILED?

  • 是 → 继续下一步请求交易详情。
  • 否 → 跳过交易详情请求(没有可用的 tx_id)。

GET 交易详情 API(b_id、wallet_code 等)

使用相关的路径和查询参数调用交易详情接口。

查看交易数据

检查返回的交易记录和详情。


请求

GET https://api.mycactus.dev/custody/v1/api/projects/{b_id}/wallets/{wallet_code}/tx-details
GET https://api.mycactus.com/custody/v1/api/projects/{b_id}/wallets/{wallet_code}/tx-details

参数

路径参数

字段类型描述
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

按创建时间排序:
允许值:

  • 0 = 降序(默认)
  • 1 = 升序
start_time
可选
Long起始时间戳 (默认:0)
end_time
可选
Long结束时间戳 (默认:当前时间)

响应

响应体

字段类型描述
codeInteger响应代码(0 = 成功)
messageString响应消息
successfulBoolean请求是否成功
dataObject详见下方 data 对象详情

data (对象)

字段类型描述
offsetInteger偏移量
limitInteger限制条数
totalInteger记录总数
listObject[]交易详情记录列表(详见下方 list 对象详情)

list (对象)

字段类型描述
idString记录ID
domain_idString企业ID
wallet_codeString钱包ID
chainString链名称
wallet_typeString钱包类型
允许值: MIXED_ADDRESS, SEGREGATED_ADDRESS
storage_typeString存储类型
允许值: PRIME_HOT, PRIME_COLD, ENTERPRISE_HOT, ENTERPRISE_COLD
wallet_nameString钱包名称
coin_nameString资产名称
full_nameString待确认
order_noString订单ID
order_typeString表示订单类型:入账或提币
block_heightLong区块高度
confirm_ratioString确认比例
tx_idString交易哈希
tx_sizeLong交易大小 (默认:1)
tx_typeString交易类型。
允许值:完整列表及描述请参阅交易类型。
withdraw_amountDecimal提币金额
withdraw_amount_strString提币金额(字符串格式)
gas_priceDecimalGas价格(ETH系列)
gas_price_strStringGas价格(ETH系列)(字符串格式)
gas_limitDecimalGas限制(ETH系列)
gas_limit_strStringGas限制(ETH系列)(字符串格式)
tx_feeDecimal交易手续费
tx_fee_strString交易手续费(字符串格式)
tx_fee_rateDecimal交易手续费率(提币)
tx_fee_rate_strString交易手续费率(提币)(字符串格式)
tx_fee_typeString交易手续费类型(提币)
miner_rewardDecimal区块奖励(入账)
miner_reward_strString区块奖励(入账)(字符串格式)
miner_feeDecimal矿工费奖励(入账)
miner_fee_strString矿工费奖励(入账)(字符串格式)
deposit_amountDecimal入账总额
deposit_amount_strString入账总额(字符串格式)
wallet_balanceDecimal钱包余额
wallet_balance_strString钱包余额(字符串格式)
tx_statusString交易状态
允许值: unconfirmed, confirmed, failed, frozen, rollbacked, unconfirmed_alarm
remark_detailString备注
tx_time_stampLong交易时间戳
create_time_stampLong创建时间戳
tr_idString旅行规则ID
contract_addressString所选代币的合约地址。该值对应于代币列表中的 智能合约字段。
token_idString仅在交易涉及 NFT 时返回;否则返回 null。
bidString业务线ID
vinsObject[]输入交易列表(VINs)
voutsObject[]输出交易列表(VOUTs)

vins (对象)

字段类型描述
addressStringVIN地址
token_addressStringVIN 交易的代币地址
idxStringVIN ID
tagStringVIN备注
amountDecimalVIN金额
amount_strStringVIN金额(字符串格式)
balanceDecimal交易后余额
balance_strString交易后余额(字符串格式)
is_changeLong是否为找零
descStringVIN描述
markString该标识字段目前仅用于 ADA(Cardano)代币交易,用于指示地址是否为备用(预备)地址。
当适用时,该字段返回 prefund_address;否则返回 null。
muxed_idString嵌入在 Stellar 多路复用地址中的 64 位整数 ID。用于在同一 Stellar 公钥下标识特定的子用户或子业务。仅适用于 Stellar (XLM) 交易;否则返回 null。
muxedStringStellar 多路复用地址(以 M 开头)。这是标准 Stellar 公钥(以 G 开头)与 64 位 ID 的编码组合,用于区分同一账户下的不同子用户或子业务。仅适用于 Stellar (XLM) 交易;否则返回 null。

vouts (对象)

字段类型描述
addressStringVOUT地址
token_addressStringVOUT 交易的代币地址
idxStringVOUT ID
tagStringVOUT备注
amountDecimalVOUT金额
amount_strStringVOUT金额(字符串格式)
balanceDecimal交易后余额
balance_strString交易后余额(字符串格式)
is_changeInteger是否为找零
descStringVOUT描述
markString该标识字段目前仅用于 ADA(Cardano)代币交易,用于指示地址是否为备用(预备)地址。
当适用时,该字段返回 prefund_address;否则返回 null。
muxed_idString嵌入在 Stellar 多路复用地址中的 64 位整数 ID。用于在同一 Stellar 公钥下标识特定的子用户或子业务。仅适用于 Stellar (XLM) 交易;否则返回 null。
muxedStringStellar 多路复用地址(以 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
}