api.py

import requests
import time

class BitcoinAPI:
    def __init__(self, base_url="https://blockstream.info/api"):
        self.base_url = base_url
        self.session = requests.Session()
        self.session.headers.update({'User-Agent': 'btc-explorer-cli/1.0'})
        self.delay = 0.5 

    def _req(self, path, is_json=True):
        time.sleep(self.delay)
        try:
            r = self.session.get(f"{self.base_url}/{path}", timeout=10)
            if r.status_code != 200:
                return None
            return r.json() if is_json else r.text
        except:
            return None

    def get_block(self, height):
        h = self._req(f"block-height/{height}", is_json=False)
        return self._req(f"block/{h}") if h else None

    def get_tx(self, txid):
        tx = self._req(f"tx/{txid}")
        if tx:
            status = self._req(f"tx/{txid}/status")
            tx['status'] = status if status else {}
        return tx

    def get_address(self, addr):
        data = self._req(f"address/{addr}")
        if data:
            txs = self._req(f"address/{addr}/txs")
            data['recent_txs'] = txs[:5] if txs else []
        return data