交易批量查询

  • 请求地址:/trans_batch_query

  • 请求方法:POST

  • 请求字段:

    名称 类型 必填 限制 描述
    version string length >=1 length <=8 版本号,本版本固定填写“2.0”
    sign_type string length >=0 length <=8 签名算法类型,本版本固定为“ECDSA”
    mch_id string length >=1 length <=32 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取)
    mch_sign string length >=1 length <=256 通讯方签名结果
    chain_id string length >=1 length <=32 链ID
    mch_pubkey string length >=1 length <=64 通讯方公钥(可使用SDK生成,在测试链中:该公钥为用户在BaaS平台【我的账户】中上传的公钥;在专属链中:该公钥为用户在节点管理平台上传的公钥。)
    src_account string length >=1 length <=64 发起方
    dst_account string length >=1 length <=64 接收方
    transaction_id string length >=1 length <=32 交易ID
    trans_type int32数组 value >=1 交易类型【当前支持: 1,发行;2,转让;3,兑付;4,签收】
    b_height uint64数组 value >=0 区块高度范围
    state int32数组 value >=0 交易状态【当前支持:2,本地已申请,4,已提交;(转让签收场景下:6,已签收;7,已拒签;8,已撤销)】
    page_limit int32 value >=0 value <=20 查询条数
    page_no int32 value >=1 页数
    timestamp int64 当前unix时间戳(秒),与服务器时间相差过远会返回失败
    trans_hash string length >=0 length <=64 区块链交易Fhash值
  • 请求示例:

http://{node_ip:node_port}/trans_batch_query
{
    "mch_sign": "MEQCID9v1SS0K1RDjbe5OnbLWRd9fY2SMWhRAHsW8IbgzStCAiBzEMh+6/cUmclb2AzWY2NPfLqujLhp7AhER/tBHwyaKA==",
    "src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
    "b_height": [
        1, 
        107087
    ],
    "version": "2.0",
    "mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
    "timestamp": "1546075883",
    "sign_type": "ECDSA",
    "chain_id": "chain_id",
    "page_limit": 3,
    "state": [
        5, 
        6
    ],
    "mch_id": "mch_id",
    "trans_type": [
        2
    ],
    "dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD",
    "page_no": 1
}
  • 应答:
{
    "version": "2.0",
    "sign_type": "ECDSA",
    "mch_id": "trust_mch",
    "mch_sign": "MEQCIAabFPJh2Hj06Ubxn4gqfzpf+6L0lKIXI8KOrVXFdndwAiA4EZM9/P+xQmZyu6KrJ/GTMWPf5EswQ8YMIVQshM0GYQ==",
    "retcode": 0,
    "retmsg": "SUCCESS",
    "total": 99,
    "trans_list": [
        {
            "trans_hash": "910b823c321c7d7e437f40c2a40e9227944b31175a4e9a5f834768f8ce47a0b4",
            "transaction_id": "201812290005782263",
            "trans_type": 2,
            "trans_state": 5,
            "src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
            "dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD",
            "src_asset_list": [
                {
                    "asset_id": "26aRcKTj8Z9yBWZsPMvgD1SnDFB2nGYc3rnQfkyYDpstLT4",
                    "fee_amount": 1,
                    "dst_amount": "9389"
                }, 
                {
                    "asset_id": "26aK5mnmjajFHxBcmHxouhgQfmtLLxwvND4dtjReRLDH1E3",
                    "fee_amount": 0,
                    "dst_amount": "9389"
                }
            ],
            "dst_asset_id": "26aJec6fvoLmJLWFaWQr5QoYz9zYqKdZwTaDLvY4CckQp5k,27tMRgyjsEv1P7EGgyLzzrh5VVWXG4NHDXn2P7nQ1wEcf6N,29CQCmroogVFTsxHoSH9vJabzq2Vgo6zVbyqRK2jqFipW6z,2AWSyrjsk84VYegJuuDJqkU8WAYU7XqhmgBeTWH5eaD2M7c",
            "left_asset_id": "27tMKbPxh7qkHV4pKSrBCmiCrRzfp9Yq2n6E1C8mh1iwWCb",
            "dst_amount": 18778,
            "left_amount": 1,
            "fee_amount": 1,
            "extra_info": {
                "test": "test"
            },
            "sign_str_list": [
                {
                    "id": 1,
                    "account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD",
                    "sign_str": "489e75d067a359c3d9988eb06ba1b88ed033ffe6543130306ac7b8960797c148"
                }
            ],
            "b_height": 3758,
            "b_time": "2018-12-29 17:22:20",
            "business": 2
        }, 
        {
            "trans_hash": "8d8e92a7aa1bd7beb0b50c4c887c140401a64e7c7e6c66ba97720991c29f91f3",
            "transaction_id": "201812250005782232",
            "trans_type": 2,
            "trans_state": 6,
            "src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
            "dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD",
            "src_asset_list": [
                {
                    "asset_id": "26aMQugYSY9HobCPzdfwdARhcDngvQafxGiCjWLQ1JQURfE",
                    "fee_amount": 1,
                    "dst_amount": "9999999999997"
                },
                {
                    "asset_id": "26aEP82bruJ5QHcdaSGAGRDRr8auBNpmQaN1xt2BoNm1H7i",
                    "fee_amount": 0,
                    "dst_amount": "10000000000000"
                }
            ],
            "dst_asset_id": "26aJJtoJm7K6GcADCvGzah5hi6VduBHyF867Xf7jeVHjiJ6,27tM5ygNhYtLMNtEKPD9W8yEDS1cKv2gXCHvZrN5TomwZJi,29CPs4ZSdzTaS9cFRr9JRarkimXakemPoGVjc3cRH8G9QKL,2AWSe9SWaS2pWvLGYK5TM2kHE73ZBPW75LhYeErm6SkMFKx",
            "left_asset_id": "27tQLtyHpF4sdtEmBZbFYd5vsWHSuc3pqCFRLPkB5qPVXjU",
            "dst_amount": 19999999999997,
            "left_amount": 2,
            "fee_amount": 1,
            "extra_info": {
                "test": "test"
            },
            "b_height": 3502,
            "b_time": "2018-12-25 16:24:25",
            "business": 2
        }, 
        {
            "trans_hash": "14dcd86d7e3046fed08913ecddc6ca2b297b8084d89dd499340a3043c7567ffa",
            "transaction_id": "201812170005782168",
            "trans_type": 2,
            "trans_state": 6,
            "src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
            "dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD",
            "src_asset_list": [
                {
                    "asset_id": "26aRGWEHrvxYjcSs3Z9feA8Y33cppNBKtDNwszeRMazNFMi",
                    "fee_amount": 1,
                    "dst_amount": "9999999999997"
                },
                {
                    "asset_id": "26a95ypAcjgQRMKbLRSJw17nCaBmkMNLkPrB9KysTot5GQp",
                    "fee_amount": 0,
                    "dst_amount": "10000000000000"
                }
            ],
            "dst_asset_id": "26aABkh7XFdxeEitdf23WPdi7VpfyN2QUqceKSRh4Ufuqcm,27tCxqaBThDCj1Suk7xCRqXEcqLeQ6m7kupTMdg2soA7gdP,29CFjvTFQ8nSonAvratMMHQm8ArcpqVq2z2GPpvNh7eKXe1,2AWJX1LKLaMgtYtwy3pWGjJHdWNbFaEYK4E5S2AiWS8XNed",
            "left_asset_id": "27tPpqY6A2AwoMJDnVkBaoZbSiERuWxqTp1UhpmcJcgUB2e",
            "dst_amount": 19999999999997,
            "left_amount": 2,
            "fee_amount": 1,
            "extra_info": {
                "test": "test"
            },
            "b_height": 2574,
            "b_time": "2018-12-17 14:33:32",
            "business": 2
        }
    ],
    "chain_id": "chain_id",
    "mch_pubkey": "AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW"
}
  • 应答字段解析:
名称 类型 必填 限制 描述
version string length >=1 length <=8 版本号,本版本固定填写“2.0”
sign_type string length >=1 length <=8 签名算法类型,本版本固定为“ECDSA”
mch_id string length >=1 length <=32 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取)
mch_sign string length >=1 length <=256 通讯方签名结果
chain_id string length >=1 length <=32 链ID
retcode int32 应答code
retmsg string 应答信息,成功时内容为SUCCESS
total int32 value >=0 交易数量
trans_list message数组 具体交易信息详细列表
trans_list.trans_hash string length >=0 length <=64 区块链交易Fhash值
trans_list.transaction_id string length >=1 length <=32 交易ID
trans_list.trans_type int32 value >=1 交易类型
trans_list.trans_state int32 value >=1 交易状态
trans_list.src_account string length >=0 length <=64 资产转出账户
trans_list.dst_account string length >=0 length <=64 资产转入账户
trans_list.src_asset_list list length >=1 length <=64 资产转出的ID列表
trans_list.dst_asset_id string length >=1 length <=64 资产转入的ID
trans_list.left_asset_id string length >=1 length <=64 剩余找零资产ID
trans_list.dst_amount uint64 value >=1 转出到目标账户的资产份额
trans_list.left_amount uint64 value >=1 剩余的资产份额
trans_list.fee_amount uint64 value >=1 手续费份额
trans_list.extra_info string 扩展信息
trans_list.sign_str_list string 当状态为2/3时,表示json string格式待签名串
trans_list.b_height int64 value >=0 交易所在的区块的高度
trans_list.b_time string length >=0 交易所在的区块的创建时间
trans_list.business int64 业务类型
date string length >=1 length <=32 查询日期
mch_pubkey string length >=1 length <=64 通讯方公钥(支持1.2以上版本)
返回顶部