【原创】比特大陆公共 API 探索(4):获取比特币交易详情


#1

BTC.com 是比特大陆旗下区块浏览器,提供 BTC、BCH 和 ETH 的区块链信息浏览查询服务,其中 BTC 和 BCH 均提供公共 API。使用公共 API 不需要密钥,目前 API 速率限制为 每分钟120次(有需要可联系提高)。

本文整理使用 API 获取比特币交易详情的实现。

BTC.com 比特币 BTC API 官方文档:https://btc.com/api-doc

API 统一响应格式:

{
    "data": ...,       //具体的 API 响应结果
    "err_no": 0,
    "err_msg": null 
}

响应体中的 data、err_no 和 err_msg 为固定字段,含义如下:

data,具体 API 响应的数据
error_no,错误码,0为正常,非0为错误,具体的错误码对照如下:

0 正常
1 找不到该资源
2 参数错误

error_msg,错误信息,供调试使用。如果没有错误,则此字段不出现。

注意:在表示金额时,为避免浮点数产生精度问题,所有的金额单位均为

查询语句:

https://chain.api.btc.com/v3/tx/{txhash}

此接口支持批量查询,英文逗号隔开即可。在获取多个交易时,如果对应的交易不存在,则为 null。

由于部分交易体积很大,为提高传输效率,比特大陆公共 API 所有涉及到交易的接口,均支持使用 verbose 参数实现交易信息的分级输出。

verbose,可选,默认为2,选择输出内容等级,含义分别如下:

等级 1,包含交易信息;
等级 2,包含等级 1、交易的输入、输出地址与金额;
等级 3,包含等级 2、交易的输入、输入 script 等信息。

示例:

获取单个交易的全部信息:

https://chain.api.btc.com/v3/tx/0eab89a271380b09987bcee5258fca91f28df4dadcedf892658b9bc261050d96?verbose=3

获取多个交易:

https://chain.api.btc.com/v3/tx/000000000000000005cb6f6e2f09e84a353ab91756a38aa50fbaf25059f76666,0ba9252660a6a5f291a8983092074f9a1da5f6d1c790518d6550f054e60bbab1

Node.js 查询示例:

const fetch = require('node-fetch');

fetch('https://chain.api.btc.com/v3/tx/{txhash}', {
    method: 'get',
}).then(response => response.json()
    .then(data => console.log(data.data)));

返回的 JSON 示例:

{
  "err_no": 0,
  "data": {
    "confirmations": 178274,
    "block_height": 388300,
    "block_hash": "000000000000000005cb6f6e2f09e84a353ab91756a38aa50fbaf25059f76666",
    "block_time": 1450070917,
    "created_at": 1520115644,
    "fee": 16087009,
    "hash": "0eab89a271380b09987bcee5258fca91f28df4dadcedf892658b9bc261050d96",
    "inputs_count": 1,
    "inputs_value": 0,
    "is_coinbase": true,
    "is_double_spend": false,
    "is_sw_tx": false,
    "weight": 516,
    "vsize": 129,
    "witness_hash": "0eab89a271380b09987bcee5258fca91f28df4dadcedf892658b9bc261050d96",
    "lock_time": 0,
    "outputs_count": 1,
    "outputs_value": 2516087009,
    "size": 129,
    "sigops": 4,
    "version": 1,
    "inputs": [
      {
        "prev_addresses": [],
        "prev_position": -1,
        "prev_tx_hash": "0000000000000000000000000000000000000000000000000000000000000000",
        "prev_type": "NONSTANDARD",
        "prev_value": 0,
        "sequence": 4294967295
      }
    ],
    "outputs": [
      {
        "addresses": [
          "1Ebb8NfVmKMoGuMJCAEbVMv2dX8GnzgxSa"
        ],
        "value": 2516087009,
        "type": "P2PKH",
        "spent_by_tx": "4eb69896a4c6ca74ac3968e8e14f3a1207db17a17340d5d61c496a5f818e546f",
        "spent_by_tx_position": 4
      }
    ]
  }
}

返回数据格式讲解:

{
    block_height: int 所在块高度
    block_time: int 所在块时间
    created_at: int 该记录系统处理时间,没有业务含义
    fee: int 该交易的手续费
    hash: string 交易哈希
    inputs: [ 输入
        {
            "prev_addresses": Array<String> 输入地址 
            "prev_position": int 前向交易的输出位置
            "prev_tx_hash": string 前向交易哈希
            "prev_value": int 前向交易输入金额
            "script_asm": string Script Asm
            "script_hex": string Script Hex
            "sequence": int Sequence
        },
    ],
    inputs_count: int 输入数量
    inputs_value: int 输入金额
    is_coinbase: boolean 是否为 coinbase 交易
    lock_time: int lock time
    outputs: [ 输出
        {
            addresses: Array<String> 输出地址
            value: int 输出金额
        }
    ],
    outputs_count: int 输出数量
    outputs_value: int 输出金额
    size: int 交易体积
    version: int 交易版本号
}

比特大陆公共 API 服务思维导图:

比特大陆公共 API