Cryptocurrency address tracing playbook
Balance, history and counterparties of a Bitcoin or Ethereum address, one hop at a time
intermediate
Looks up a Bitcoin address: balance, totals, recent transactions and counterparties
Community-packaged from github.com/osintverse-community/btc-address: the registry's community pins the upstream release; the tool is its authors' work. Maintain that project? Claim this package.
Run
Through ot mcp, an agent calls run_tool with this; ot asks you before anything that goes online or touches a target. Set it up: ot mcp install claude (or cursor, vscode, codex, gemini).
{"tool":"osintverse-community/btc-address","target":"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa","input_type":"crypto_address"}Or just say: "Run osintverse-community/btc-address on 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa with OTInstaller." The registry's read-only MCP server at api.otinstaller.com/mcp can find tools without installing anything.
ot run osintverse-community/btc-address --address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa --format tableot install osintverse-community/btc-addressDocker image in a read-only container · talks to blockstream.info · no key · up to 1 min. The first ot run installs the tool after asking once. The example value is the registry's own test input, so this command has run. Drop --format table for JSON.
ot? Install it in one linecurl -fsSL https://get.otinstaller.com/ot | shot release for your machine from GitHub Releases.checksums.txt, and the Ed25519 signature on that file against the key built into the script.ot in /usr/local/bin or ~/.local/bin. Nothing else is written. Read the script.irm https://get.otinstaller.com/ot.ps1 | iexot release for your machine from GitHub Releases.checksums.txt, and the Ed25519 signature on that file against the key built into the script.ot in %LOCALAPPDATA%\Programs\ot, and adds it to your PATH. Nothing else is written. Read the script.sha256:064e8edc…185b9a. The same bytes on every install; ot pulls by digest, never by tag.ot checks the same identity before every install and refuses another signer.ot pulls the same digest from the mirror and checks the same signature.{
"envelope": 1,
"tool": "osintverse-community/btc-address@0.1.0",
"runtime": "docker",
"input": {
"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
},
"started_at": "2026-10-21T09:00:00Z",
"duration_ms": 4100,
"exit_code": 0,
"entities": [
{
"type": "crypto_address",
"value": "1BoatSLRHtKNngkdXEeobR76b53LETtpyT",
"attrs": {
"chain": "btc"
}
},
{
"type": "transaction",
"value": "4a5e1e4b…",
"attrs": {
"amount": "0.5 BTC"
}
}
],
"warnings": []
}Every tool returns this shape, shaped here from what this tool declares it finds. --format table to read it; ot extract and ot auto to continue.
Looks up a Bitcoin address (legacy, P2SH or bech32) on the public Blockstream Esplora API and reports its balance, total received and sent, transaction count, its 25 most recent transactions and the addresses on the other side of them.
ot run osintverse-community/btc-address --address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
| Input | Required | |
|---|---|---|
address |
yes |
Counterparties are the input addresses of incoming transactions and the outputs of outgoing ones; outputs include change addresses that belong to the same wallet. No API key is needed; Blockstream sees the addresses you look up.
For Ethereum, use osintverse-community/eth-address.
pip install # no dependencies
python -m unittest
ot validate
Releases are built, signed and published by the otinstaller release workflow (Actions tab, with the version to release).
MIT
Balance, history and counterparties of a Bitcoin or Ethereum address, one hop at a time
btc-address finds crypto address, transaction. Tools that take those:
Alternatives to btc-address that also take a crypto address; ot auto runs every installed one on the same value.
Looks up an Ethereum address: balance, ENS name, contract info, recent transactions