checkaddy

A simple terminal application for validating and inspecting public cryptocurrency addresses across multiple networks. It performs local format validation and optionally fetches basic address data from public blockchain APIs.

Features

• Local validation for several address formats
• Support for both UTXO and EVM chains
• Fetches balance and transaction metadata from public endpoints
• Terminal UI built with textual
• Optional JSON output for raw data
• Explorer links for quick inspection in a browser

Supported Networks

• Bitcoin (BTC)
• Litecoin (LTC)
• Dogecoin (DOGE)
• Dash (DASH)
• Bitcoin Cash (BCH)
• Ethereum (ETH)
• BNB Chain (BSC)
• Polygon (MATIC)

What it Shows

Depending on the network and API availability:

• Confirmed balance
• Unconfirmed balance
• Total received
• Total sent
• Transaction count
• Data source used for the lookup

Requirements

• Python 3.10+
• requests
• textual

Install dependencies:

pip install requests textual

Running

python run.py

Or install the command locally:

pip install -e .

Launch the Textual UI:

checkaddy

Check an address directly in the terminal:

checkaddy <address> --coin BTC

If the address format maps to exactly one supported network, --coin can be omitted:

checkaddy <address>

For EVM addresses and legacy formats that can belong to multiple networks, pass the network explicitly:

checkaddy 0x0000000000000000000000000000000000000000 --coin ETH
checkaddy 0x0000000000000000000000000000000000000000 --coin MATIC --json

Notes

• Only public wallet addresses are supported.
• Private keys or seed phrases should never be entered.
• Some values may be unavailable depending on the limitations of free API endpoints.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Copyright (c) 2026 zv.