简介:BTC.com 是比特大陆旗下区块浏览器,提供 BTC、BCH 和 ETH 的区块链信息浏览查询服务,其中 BTC 和 BCH 均提供公共 API。本文整理使用 API 获取比特币交易详情的实现。
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 输入地址
"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 输出地址
value: int 输出金额
}
],
outputs_count: int 输出数量
outputs_value: int 输出金额
size: int 交易体积
version: int 交易版本号
}
比特大陆公共 API 服务思维导图:
我们有一个区块链知识星球,做区块链前沿资料的归纳整理以方便大家检索查询使用,也是国内顶尖区块链技术社区,欢迎感兴趣的朋友加入。如果你对上面内容有疑问,也可以加入知识星球提问我: