查询钱包交易记录明细

请求

GET https://custody-example-url/custody/v1/api/projects/{b_id}/wallets/{wallet_code}/tx-details

参数

字段 类型 描述
b_id String 业务线id
wallet_code String 钱包编号
coin_name 可选 String 币种(查询归一钱包下其他资产流水)
允许值: 参考币种列表Symbol (For API)
tx_types可选 String[] tx 类型
addresses可选 String[] 地址
id可选 Long 钱包交易详情id
tx_id可选 String 交易hash
order_no可选 String 订单号
offset可选 Integer 如果不传,默认0
limit可选 Integer 如果不传,默认10
create_time_order 可选 Integer 创建时间排序:0表示降序,1表示升序,如果都不传默认降序
允许值: 0, 1
start_time可选 Long 查询时间段的开始时间戳,不传则默认为0,即1970/00/00 00:00:00.000
end_time可选 Long 查询时间段的结束时间戳,不传则默认为当前时间点

响应

字段 类型 描述
code Integer 响应状态码
message String 响应信息
successful Boolean 请求是否成功
data Object 钱包列表数据
total Integer 总数据量
offset Integer offset
limit Integer limit
list Object[] 钱包明细列表
id String 记录ID
domain_id String 公司ID
b_id String 业务线ID
wallet_code String 钱包编号
chain String 链信息
wallet_type String 钱包类型(MIXED_ADDRESS-地址混用 SEGREGATED_ADDRESS-地址隔离)
允许值: MIXED_ADDRESS, SEGREGATED_ADDRESS
coin_name String 币种名称
order_no String 订单编号
block_height Long 交易块高度
confirm_ratio String 未确认交易的确认比例(2:6-表示需要6个块达到安全确认,当前只有2个块确认,安全确认后值为null)
tx_id String 交易hash
tx_size Long 交易大小(无交易大小的币种,默认显示1)
tx_type String 业务类型(WITHDRAW-提币 DEPOSIT-入账 PREFUND_DEPOSIT-备付金入账 DEPOSIT_ROLLBACK-转入失败 WITHDRAW_CREDIT-授权转出 WITHDRAW_FAILED-转出失败 WITHDRAW_REFUND-转出失败退款 WITHDRAW_CANCELED-转出取消 MINER_REWARD-爆快 FEE_PAYMENT-支付矿工费 ADVANCED_FEE-垫付矿工费 CONSOLIDATION-归集 REBASE-代币供应量调整)
允许值: WITHDRAW, DEPOSIT, PREFUND_DEPOSIT, MINER_REWARD, FEE_PAYMENT, ADVANCED_FEE, CONSOLIDATION, DEPOSIT_ROLLBACK, WITHDRAW_CREDIT, WITHDRAW_FAILED, WITHDRAW_CANCELED, WITHDRAW_REFUND, REBASE
withdraw_amount Decimal 提币额度(提币)
gas_price Decimal eth系列提币汽油价格
gas_limit Decimal eth系列提币汽油上限
tx_fee Decimal 交易费
tx_fee_rate Decimal 交易费费率(提币)
tx_fee_type String 交易费币种(提币).
miner_reward Decimal 爆块矿工系统奖励(入账)
miner_fee Decimal 爆块矿工费收入(入账)
deposit_amount Decimal 收入总额(入账)
wallet_balance Decimal 钱包余额
tx_status String 交易状态(unconfirmed-未确认、confirmed-已安全确认、failed-失败、frozen-交易冻结、rollbacked-入账回滚、unconfirmed_alarm-入账长时间未确认)
允许值: unconfirmed, confirmed, failed, frozen, rollbacked, unconfirmed_alarm
remark_detail String 备注
tx_time_stamp Long 交易时间戳
create_time_stamp Long 入账时间戳
vins Object[] 付款方地址信息
-address String 地址
-idx String 地址的序号
-tag String memo
-amount Decimal 交易额度
-balance Decimal 交易后地址余额
-is_change Long 是否是找零
-desc String 描述信息
vouts Object[] 收款方地址信息
-address String 地址
-idx String 地址序号
-tag String memo
-amount Decimal 交易额度
-balance Decimal 交易后地址余额
-is_change Integer 是否是找零
-desc String 描述信息

响应示例

{
    "code": 0,
    "message": "",
    "data": {
        "offset": 9,
        "limit": 10,
        "list": [
            {
                "id": 2187,
                "domain_id": "a5b3f782c4e24c688eca60946442a75f",
                "domain_name": null,
                "domain_code": null,
                "kyc_number": null,
                "service_type": null,
                "wallet_code": "CHBTC6731708813",
                "wallet_type": "SEGREGATED_ADDRESS",
                "coin_name": "BTC",
                "order_no": null,
                "block_height": 1691839,
                "confirm_ratio": null,
                "tx_id": "617e02248e1620b6d5a65a531fc8fcbb412c2e34c840be048add18215e49e94e",
                "tx_size": 293,
                "tx_type": "DEPOSIT",
                "withdraw_amount": null,
                "gas_price": null,
                "gas_limit": null,
                "tx_fee": 590,
                "tx_fee_rate": null,
                "tx_fee_type": null,
                "miner_reward": null,
                "miner_fee": null,
                "deposit_amount": 300000,
                "wallet_balance": 20309373,
                "extended_info": {
                    "domain_coin_balance": 500073396381,
                    "attachments": null
                },
                "tx_status": "confirmed",
                "remark_detail": null,
                "vins": [
                    {
                        "address": "mnxUp4iXgSrAhHEipDjH5pkZMhVPSDqUjK",
                        "idx": 1,
                        "tag": null,
                        "amount": null,
                        "balance": null,
                        "is_change": 0,
                        "desc": null
                    }
                ],
                "vouts": [
                    {
                        "address": "mnxUp4iXgSrAhHEipDjH5pkZMhVPSDqUjK",
                        "idx": 1,
                        "tag": null,
                        "amount": 300000,
                        "balance": 18219851,
                        "is_change": 1,
                        "desc": ""
                    }
                ],
                "tx_time_stamp": 1585539864000,
                "create_time_stamp": 1585539503000,
                "bid": "ed70ff75b1fe4994a3bd836befe0e87f"
            }
        ],
        "total": 1
    },
    "successful": true
}
Copyright © 2025 Cactus Custody all right reserved,powered by GitbookUpdated: 17-Apr-2025 10:11:15

results matching ""

    No results matching ""

    results matching ""

      No results matching ""