02_address.py

# SPDX-License-Identifier: MIT
"""02 - An address's balance and unspent outputs (UTXOs), from the API.

Balance = funded - spent (in satoshis). Pass your own address, or use the demo one.

    python 02_address.py [address]
"""
import sys
import requests
from config import api

# A funded btc-testnet4 address as a default; pass your own as an argument.
addr = sys.argv[1] if len(sys.argv) > 1 else "tb1plgytt9l0u7p344gx4xzwfajnvnqvum3ed2sskd2rmj5x2k75fpwqey0tq7"

info = requests.get(api(f"/address/{addr}"), timeout=15).json()
c = info["chain_stats"]
balance = c["funded_txo_sum"] - c["spent_txo_sum"]
print(f"address : {addr}")
print(f"balance : {balance:,} sats  ({balance / 1e8:.8f})")
print(f"tx count: {c['tx_count']}")

utxos = requests.get(api(f"/address/{addr}/utxo"), timeout=15).json()
print(f"utxos   : {len(utxos)}")
for u in utxos[:10]:
    state = "confirmed" if u["status"]["confirmed"] else "unconfirmed"
    print(f"  {u['txid']}:{u['vout']}  {u['value']:,} sats  ({state})")