轻松查询比特币钱包余额：QuickNode BTC Blockbook JSON-RPC 实战指南

给项目加“读链”功能时，最常见的需求就是——看一眼陌生地址的比特币余额。自己跑全节点？内存爆炸。只读钱包再多也难扩展。QuickNode 的 BTC Blockbook JSON-RPC 附加组件 用 3 条 RPC 把整个难题压缩成了 1 行 cURL。本文就用它来实时获取 比特币地址余额、最新交易与 UTXO 明细，代码、参数、避坑一次说透。

为什么选择 QuickNode 的 BTC Blockbook？

无节点维护成本：云托管，全自动。
三条核心方法：bb_getAddress、bb_getUTXOs、bb_getXPUB 一步到位。
秒级同步：直连主网，区块高度实时。
开发者友好：标准 JSON-RPC，任何语言都能调。

核心关键词：比特币余额查询、QuickNode RPC、BTC Blockbook、bb_getAddress、未花费交易输出 UTXO。

三步搭建「随调随用」的查询端点

1. 注册并启用比特币主网节点

注意：Blockbook 为高级付费插件，请根据预算选套餐；新建成功后会拿到类似 https://xxx.btc.quiknode.pro/ 的 HTTP Provider URL。

2. 一键安装 BTC Blockbook 附加组件

仪表盘找到 Marketplace → 搜索 Blockbook → 开启即可。无需额外编译或端口配置。

3. 记录你的 HTTP Provider URL

复制「HTTP Provider URL」，下文的 cURL 命令全靠它。

用 bb_getAddress 拉取余额 & 交易明细

快速请求示例

把下面命令粘进终端，并把 YOUR_QUICKNODE_HTTP_PROVIDER_URL 替换为上一步拿到的地址：

curl YOUR_QUICKNODE_HTTP_PROVIDER_URL \
  -H "Content-Type: application/json" \
  -d '{"method": "bb_getAddress", "params": ["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", {"page":1, "size":10, "fromHeight":0, "details":"txids"}]}'

参数速查

参数名	作用说明
`page`	第几页交易
`size`	每页条数，最大 1000
`fromHeight`	起始区块高度，填 0 表示全网搜索
`details`	basic/txids/txs 依次返回越来越丰富的字段

输出单位 satoshis（聪）：1 BTC = 100,000,000 聪。
响应字段示例：

{
  "balance": 7263430323,
  "totalReceived": 7263430323,
  "totalSent": 0,
  "txids": ["abc123...", ...]
}

换算后，该地址余额 ≈ 72.63 BTC。

讨巧小技巧：
jq 把 1 行长串 JSON 秒变可读格式：

curl ... | jq

UTXO 小白进阶：如何用它做余额校验？

不想暴露私钥？把地址余额拆成 UTXO 集合 最稳。换用 bb_getUTXOs 即可：

curl YOUR_QUICKNODE_HTTP_PROVIDER_URL \
  -H "Content-Type: application/json" \
  -d '{"method":"bb_getUTXOs","params":["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"]}' \
  | jq '.[] | {value, txid}'

这样就能检查每一笔可用的 sat 去向，防女巫、过滤黑 UTXO 妥妥的。

现场动手：Python Demo 封装

不想手写 cURL？5 行 Python（使用 requests）搞定：

import requests, json

url = "YOUR_QUICKNODE_HTTP_PROVIDER_URL"
payload = {
    "method": "bb_getAddress",
    "params": ["bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", {"details":"txids", "size": 5}]
}
res = requests.post(url, json=payload).json()
balance_btc = res['result']['balance'] / 1e8
print(f"余额：{balance_btc} BTC")

FAQ：常被问到的 5 个细节

Q1：免费套餐能用 Blockbook 吗？
A：目前 Blockbook 仅限付费套餐，但每月 20 美元起，比自建节点省电费。

Q2：查询频率会有限制吗？
A：受套餐 QPS 限制；超出后返回 429，需加指数回退重试。

Q3：如何一次拿到整页最全字段？
A：把 details 设为 txs，即可获得每笔交易的输入、输出细节。

Q4：fromHeight 该填多少合适？
A：第一次跑建议 0，全量回血。日常监听可设成最近区块高度减 6 约 1 小时。

Q5：扩展公钥 XPUB 跟地址有什么区别？
A：XPUB 可批量派生无数子地址，用于 HD 钱包。用 bb_getXPUB 一次性汇总所有子账户余额，避免逐个地址查询折腾。

结语

💡 掌握「QuickNode + BTC Blockbook」后：

不做节点维护，依然能 实时查看任意地址的比特币余额、UTXO 与交易哈希。
SDK / 命令行 / Postman / Python，调用方式随心选。
把重点放回业务逻辑，迅速上线钱包浏览器、排行榜、合规审计等场景。

👉 想要更深入地玩转链上数据？立刻查看这份 闪电入门文档集：如何 10 分钟搭好比特币数据看板。

原文日期已删除，标题中不含品牌后缀。