Phase 2 — Address Balance Checker

[devdavidejesus]

Phase 2 — Address Balance Checker

Query any Bitcoin address balance via Mempool.space API.

Scope

• Fetch confirmed balance (chain_stats)
• Fetch unconfirmed balance (mempool_stats)
• Display total funded/spent amounts
• Transaction count
• Support for all address types: P2PKH (1...), P2SH (3...), Bech32 (bc1q...), Taproot (bc1p...)
• Testnet support

Endpoints

• GET /api/address/:address
• GET /api/address/:address/utxo

CLI interface

python -m btc_toolkit balance <address>
python -m btc_toolkit balance <address> --json
python -m btc_toolkit balance <address> --utxo
python -m btc_toolkit balance <address> --network testnet

Constraints

• Zero external dependencies (stdlib only)
• Unit tests with mocked API responses
• Verified example addresses in README

References

• Mempool.space API docs: https://mempool.space/docs/api/rest#get-address