Blockchain developers and cryptocurrency enthusiasts often need to retrieve real-time data from the Bitcoin network—especially the balance of a specific Bitcoin address. While running a full Bitcoin node gives you direct access to blockchain data, it comes with scalability challenges when querying balances for multiple addresses. This is where QuickNode’s BTC Blockbook JSON-RPC Add-On becomes invaluable.
In this guide, you’ll learn how to efficiently look up the balance, transaction history, and unspent transaction outputs (UTXOs) of any Bitcoin address using QuickNode’s optimized RPC methods—all without the overhead of managing watch-only wallets or running memory-intensive processes.
Why Use QuickNode for Bitcoin Address Queries?
When interacting with the Bitcoin blockchain, scalability and performance matter. Traditional approaches like importing addresses into a watch-only wallet using Bitcoin Core can work for one or two addresses, but they quickly become impractical at scale. Each added address increases memory usage, making this method unsuitable for applications such as wallets, block explorers, or analytics platforms.
QuickNode solves this problem with its Blockbook RPC Add-On, a powerful extension that enables developers to query address data directly via lightweight JSON-RPC calls. This add-on supports three essential methods:
bb_getUTXOs– Retrieve all unspent transaction outputs for an address or XPub key.bb_getXPUB– Fetch balance and transaction details for hierarchical deterministic (HD) wallet public keys.bb_getAddress– Get balance and transaction history for a single Bitcoin address.
We’ll focus on bb_getAddress, which allows you to retrieve comprehensive information about any Bitcoin address in seconds.
An Extended Public Key (XPuB) is part of a hierarchical deterministic (HD) wallet system. It enables the generation of multiple public addresses from a single master key, commonly used in modern cryptocurrency wallets for improved security and usability.
A UTXO (Unspent Transaction Output) represents coins that have been received but not yet spent. These outputs serve as inputs for new transactions and are critical for verifying available balances on the Bitcoin network.
Setting Up Your Bitcoin Endpoint on QuickNode
To begin, you’ll need a QuickNode endpoint with the Blockbook RPC Add-On enabled.
- Go to QuickNode and sign up or log in.
- Select Bitcoin as the blockchain and choose the Mainnet network.
- Proceed to configure add-ons and select a paid plan—this add-on is only available on paid tiers.
- Enable the Blockbook RPC Add-On during setup.
- Once your node is created, copy your QuickNode HTTP Provider URL—you’ll use it to make API calls.
This setup takes less than two minutes and gives you instant access to high-performance Bitcoin data queries.
👉 Get instant access to scalable Bitcoin node infrastructure with advanced querying tools.
Making Your First bb_getAddress Call
With your endpoint ready, you can now query any Bitcoin address using a simple cURL command.
Here’s an example that retrieves balance and recent transactions for the well-known Bitcoin genesis address:
curl YOUR_QUICKNODE_HTTP_PROVIDER_URL \
--header 'Content-Type: application/json' \
--data '{"method": "bb_getaddress", "params": ["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", {"page": 1, "size": 10, "fromHeight": 0, "details": "txids"}]}'Understanding the Parameters
page: Specifies which page of results to return (useful for pagination).size: Number of transactions per page (maximum varies by plan).fromHeight: Filters transactions starting from a specific block height.details: Controls the response format:basic: Minimal data (balance and transaction count).txids: Includes transaction IDs.txs: Returns full transaction objects.
The response includes:
- Current balance in satoshis (sat).
- Total received and sent amounts.
- Count of total transactions.
- List of recent transaction IDs (or full TX data if
details: "txs").
⚠️ All monetary values are returned in satoshis—the smallest unit of Bitcoin. 1 BTC = 100,000,000 satoshis.
For better readability, format the JSON output using tools like jq or pjson:
curl ... | jqAt the time of writing, querying the genesis address (1A1zP...) returns a balance of approximately 72.634 BTC, reflecting early mining activity and long-term holding behavior.
Monitoring and Debugging with Logs
QuickNode provides built-in logging for all RPC endpoints. If your requests fail or return unexpected results, simply visit your dashboard to review request logs. This feature helps you debug issues related to rate limits, invalid parameters, or network errors—without needing external monitoring tools.
Log retention periods depend on your subscription level, so check the pricing page for details.
👉 Scale your Web3 application with reliable, low-latency Bitcoin node access.
Frequently Asked Questions
What is the difference between bb_getAddress and Bitcoin Core’s getaddressinfo?
getaddressinfo only works for addresses imported into your local wallet (even if watch-only), consuming memory and slowing down your node. bb_getAddress queries external indexers via QuickNode’s Blockbook layer—no import required, and no performance cost.
Can I use this method for HD wallets?
Yes! For HD wallets, use bb_getXPUB instead. It accepts an extended public key (xpub) and returns aggregated balances and transaction histories across all derived addresses.
Is there a rate limit for these RPC calls?
Yes, rate limits vary based on your QuickNode plan. Higher-tier plans offer increased request capacity and faster response times—ideal for production applications.
How accurate is the balance data?
Data is synced in near real-time from the Bitcoin blockchain through Blockbook indexing servers. Delays are typically under a few seconds, ensuring high accuracy for live applications.
Do I need a full node to use this add-on?
No. QuickNode hosts the infrastructure—you just make HTTP calls. This eliminates the need to sync or maintain your own node while still giving you full RPC functionality.
Can I retrieve full transaction details?
Yes. Set the details parameter to "txs" in your request. The response will include complete transaction data, including inputs, outputs, fees, and confirmation status.
Conclusion
Efficiently retrieving Bitcoin address balances is crucial for wallet development, blockchain analytics, and decentralized applications. With QuickNode’s Blockbook RPC Add-On, you gain instant access to scalable, reliable, and easy-to-use tools that eliminate the limitations of traditional node setups.
Whether you're building a wallet interface, analyzing on-chain activity, or verifying payments, the bb_getAddress method streamlines your workflow with minimal configuration and maximum performance.
Ready to supercharge your Bitcoin development?
👉 Start building with fast, secure, and developer-friendly blockchain infrastructure today.
And don’t forget to explore more tools in the QuickNode Marketplace to accelerate your Web3 projects.