CustodyAccount Asset

1.账户验证

参照custodyAccount章节的账户验证

custodyAccount

2.查询账户的资产持有

弃用，使用coustodyAccount第9条

POST:/custodyAccount/Asset/queryassets

查询账户资产持有及价值

请求体：无

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": [
        {
            "assetId": "644396bc5c82966c0b1487e80449266c4b8dba9067b4e38ee4feddf6ee128c02",
            "amount": 1100,
            "prices": 0
        },
        {
            "assetId": "f2102dc5d983c84bef23d6928c8aababc1d06bcfa8b232e215ff45741546a46e",
            "amount": 515,
            "prices": 0
        },
        {
            "assetId": "test2",
            "amount": 10,
            "prices": 0
        }
    ]
}

assetId：资产ID string
amount：数量 int
prices: 资产价值（单位美元，有小数点）float

3.查询指定资产持有

弃用，使用coustodyAccount第8条

POST：/custodyAccount/Asset/queryasset

查询账户资产持有（无价值）

请求体：

{
    "asset_id":"59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7"
}

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": [
        {
            "assetId": "59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
            "amount": 4000000
        }
    ]
}

4.申请接收资产的地址

/custodyAccount/Asset/apply

请求体：

{
    "asset_id":"59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
    "amount": 120
}

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": {
        "addr": "taprt1qqqszqspqqzzqkd9thq30l4ruzmqta9evjr3tqp94pz3ec9pqqfgfp6exwrykad8qcssy86wy2wgv9r2d5vddnrhm3wv4c82ajtxq8jpakhhcn0s3h6ngsrvpqss8xp00n6l9zpp7xxxaj4ka65tax3ekcvm3t96drzu0ehun5pjk8z9pgqhsrppw4hxjan9wfek2unsvvaz7te3xvezuv3nxghrzvpe9curgw3cxs6rxx5wzvn"
    }
}

5.查询指定资产条目下的地址

/custodyAccount/Asset/queryaddress

请求体

{
    "asset_id":"59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7"
}

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": [
        {
            "addr": "taprt1qqqszqspqqzzqkd9thq30l4ruzmqta9evjr3tqp94pz3ec9pqqfgfp6exwrykad8qcssyz87wrgryqk7ckfzctxchudd4ea80cg3p2tfa4vjqrv9hcyvvgelpqssxpx3wzwp9sgp8k5zclkqdmmywdkptcdgae7gzjyh3hjs857m7yhkpgqhsrppw4hxjan9wfek2unsvvaz7te3xvezuv3nxghrzvpe9curgw3cxs6rxzawu44",
            "asset_id": "59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
            "amount": 120,
            "createTime":222222222
            
        }
    ]
}

6.查询所有资产的所有地址

/custodyAccount/Asset/queryaddresses

请求体：无

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": [
        {
            "addr": "taprt1qqqszqspqqzzqkd9thq30l4ruzmqta9evjr3tqp94pz3ec9pqqfgfp6exwrykad8qcssyz87wrgryqk7ckfzctxchudd4ea80cg3p2tfa4vjqrv9hcyvvgelpqssxpx3wzwp9sgp8k5zclkqdmmywdkptcdgae7gzjyh3hjs857m7yhkpgqhsrppw4hxjan9wfek2unsvvaz7te3xvezuv3nxghrzvpe9curgw3cxs6rxzawu44",
            "asset_id": "59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
            "amount": 120
        },
        {
            "addr": "taprt1qqqszqspqqzzqkd9thq30l4ruzmqta9evjr3tqp94pz3ec9pqqfgfp6exwrykad8qcss92f3ay7749lwahmh8ftxlkdnlc6vnxrg2gqw8kdn2hy8kxrcf24hpqss84zectx0yqjf62sjgdj0h370kfp0wgx4vzx44xvjqpmmy0cd089ypgpl6p9jpssh2mnfwejhyum9wfcxxw309ucnxv3wxgenyt33xqujuwp58gurgdpnut0f7v",
            "asset_id": "59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
            "amount": 1202
        },
        {
            "addr": "taprt1qqqszqspqqzzqkd9thq30l4ruzmqta9evjr3tqp94pz3ec9pqqfgfp6exwrykad8qcss98ax20nfeexyyuglx46qgz4085rurq2d644zk49qmu0ev2p5f4q9pqss9ky2s5l76w0p2ecrk02glgsj5cgmj2kv2t8ys635c4cefsqwzzqgpgpl6p9jpssh2mnfwejhyum9wfcxxw309ucnxv3wxgenyt33xqujuwp58gurgdpns4e6cv",
            "asset_id": "59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
            "amount": 1202
        }
    ]
}

7.发送资产

/custodyAccount/Asset/send

请求体：

{
    "address":"lnbcrt10n1p5q3pj0pp5qkldexshttpu3kk7cam2tje406852gsuak0tfa3dwt57d2kvuu9qdqqcqzzsxqzfvrzjq2mljeaghr9azh0pmvdz3836uxq549yhdfd96unryz5njjjw9jc74a8yh2kxtsecjqqqqqlgqqqqqqgq2qsp5tzg6x7qdk06a90t98m4svzxfyk3ugh9gg0ynpytea0hhkcc53uxs9qxpqysgqj7jvqqlxr2mcdq5y5vmz0s4782p9lkmtar4mgvld5lntw33n9hp5ty29tw5uf60q46yccwhrg93l96sq8qhz5uzrgj3afs3emlw0clsq8zqpls",
    //"rfq_peer_key":""
    "asset_id"
}

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": {
        "success": "success"
    }
}

更新：4/23.增加rfq_peer_key字段，仅用于支付对外的资产发票，当为链上地址或内部支付资产发票时忽略此字段
10/14.该接口支持通道发票的支付，配套接口参考custodyAccount Asset Channel章节。增加asset_id字段。

8.查询交易记录

/custodyAccount/Asset/querypayment

请求体：

{
    "asset_id": "00",
    "page":1,//页数
    "page_size":2,//页面大小
    "away":0 //入账0，出账1
}

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": {
        "payments": [
            {
                "timestamp": 1726214098,
                "bill_type": 2,
                "away": 1,
                "target": "taprt1qqqszqspqqzzqkd9thq30l4ruzmqta9evjr3tqp94pz3ec9pqqfgfp6exwrykad8qcssym8q4w9lk96590wgkxfg8nzw0x9ljkfg75cey5p0amvcavkv4k8hpqss8l5uwjkc9a6jfgd3yu3uc2fnmxf9sezz8gdys00t6jfm68q0dgv0pgqhsrppw4hxjan9wfek2unsvvaz7te3xvezuv3nxghrzvpe9curgw3cxs6rx77ur2z",
                //原“target”字段
                "amount": 120,
                "asset_id": "59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
                "state": 1,
                "fee": 0
            }
        ]
    }
}

timestamp：时间
bill_type：交易类型
away：0 转入 1 转出
target：关联地址
amount：金额
asset_id：币种类型。
state:状态，0 处理中，1 成功，2 失败，3成功
fee：交易产生的额外费用

addr：关联地址(弃用，更变为target）

更新：addr字段变更为target，未来版本删除addr

9.解码发票

/custodyAccount/Asset/decodeaddr

请求体：

{
    "addr":"taprt1qqqszqspqqzzqkd9thq30l4ruzmqta9evjr3tqp94pz3ec9pqqfgfp6exwrykad8qcssym8q4w9lk96590wgkxfg8nzw0x9ljkfg75cey5p0amvcavkv4k8hpqss8l5uwjkc9a6jfgd3yu3uc2fnmxf9sezz8gdys00t6jfm68q0dgv0pgqhsrppw4hxjan9wfek2unsvvaz7te3xvezuv3nxghrzvpe9curgw3cxs6rx77ur2z"
}

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": {
        "AssetId": "59a55dc117fea3e0b605f4b96487158025a8451ce0a1001284875933864b75a7",
        "assetType": "NORMAL",
        "amount": 120,
        "feeRate": 100.00
    }
}

AssetId：资产Id
assetType：NORMAL普通资产，其他类型暂不支持
amount :数量
feeRate : 估算向该地址发送托管资产时产生的总费用，单位sat。（该字段仅用于托管资产发送时费用估算）