Bitiodine is a free, open-source command-line tool for analyzing the Bitcoin blockchain. It is aimed at developers, researchers and analysts who want to run their own heuristics over raw Bitcoin Core block data rather than rely on third-party explorers.
Because it reads the data your own node has already stored, it gives you direct control over what is analyzed and how. The project is written in Rust and released under the MIT license, so you can read, modify and extend the code for your own purposes.
What Cluster Analysis Means in Bitcoin
Bitcoin addresses are pseudonymous, but transactions are public. Cluster analysis is the practice of grouping addresses that are likely controlled by the same entity, based on patterns in how they spend funds together. A common example is multiple inputs to a single transaction, which usually indicates shared control of those inputs.
Tools like Bitiodine do not label addresses with real-world identities. They produce groupings that you can then test, refine and compare with other evidence. Results are best treated as probabilistic hypotheses, not confirmed facts.
Who Bitiodine Is For
The tool suits people who are comfortable with a terminal and have some understanding of Bitcoin's data structures. Typical users include blockchain researchers studying transaction patterns, developers building analytics pipelines, and privacy-focused engineers who want to understand how their own transactions might be linked.
If you only need quick lookups of individual addresses or transactions, a block explorer will be faster. Bitiodine is more useful when you need bulk analysis, custom logic, or repeatable results over a fixed snapshot of the chain.
How the Data Pipeline Works
Bitiodine reads block files written by Bitcoin Core. It supports both legacy and SegWit transaction serialization, and it handles the xor.dat obfuscation that newer Bitcoin Core versions apply to block files on disk.
The analysis assumes that the input data is trustworthy. The tool does not re-verify proof of work, scripts or the full consensus rules. For that reason, the project recommends pointing it at a consistent snapshot and specifying a trusted chain tip, so that every block and its ancestry come from the same known-good state.
Why a Trusted Chain Tip Matters
Block files can retain blocks that were received but are not part of the active chain, so selecting a chain by cumulative work alone does not guarantee that you are analyzing Bitcoin Core's active chain. Supplying a trusted --chain-tip, such as the output of bitcoin-cli getbestblockhash captured at snapshot time, anchors the analysis to a specific block.
This step is easy to skip and important to get right. Without it, your results may reflect a different branch of the chain than the one you intended to study.
Key features
Pluggable Visitor Architecture
Established Hashing and Work Arithmetic
Command-Line Action Selection
Supported coins
The documentation mentions Bitcoin (BTC) as the supported network. The tool is designed for Bitcoin Core mainnet data specifically.
How to install Bitiodine on Windows
- 1
Download the program
Get the source code from the official GitHub repository at https://github.com/mikispag/bitiodine. Download only from the official site or the project's GitHub page, and prefer a tagged release over an arbitrary commit.
- 2
Verify the download
Check the SHA-256 checksum or signature of the release if the maintainers publish one, and compare it with the value you compute locally. Do not use copies of the code from unofficial mirrors or forums.
- 3
Build or install
Because the project is written in Rust, you will typically build it with the Rust toolchain. Follow the build instructions in the repository, then run the resulting binary from a terminal.
-
Prepare a Bitcoin Core snapshot
Point the tool at block data from a Bitcoin Core node you control, along with the chain tip you captured. Make sure the snapshot is internally consistent before starting the analysis.
System requirements
- A full, unpruned Bitcoin Core node is required, because the analysis reads the complete block files
- Windows, macOS or Linux, according to the project's platform list
- Sufficient disk space to store the Bitcoin Core block data, which runs to hundreds of gigabytes
How to use Bitiodine
Bitiodine is run from the command line. The general workflow is to prepare a snapshot of Bitcoin Core data, specify the chain tip, and choose the visitor you want to run. Exact flags and options are documented in the repository, so check the README for the current syntax.
A typical session looks like this:
- Stop or pause your Bitcoin Core node and copy the block directory so the data stays consistent during analysis.
- Record the active chain tip with bitcoin-cli getbestblockhash and keep the output with your snapshot.
- Run Bitiodine with the --chain-tip option set to that hash and the path to the copied block files.
- Select the action or visitor you want, either a built-in one or your own implementation of the BlockChainVisitor trait.
- Review the output and record the exact version of the code and the chain tip, so the run can be reproduced later.
Pros & cons
- Free and open source under the MIT license
- Lets you write custom analysis logic using a clear trait-based interface
- Works directly on your own Bitcoin Core data, with no reliance on third-party APIs
- Supports both legacy and SegWit serialization and xor.dat obfuscation
- Command-line design suits scripting and repeatable research
- Requires a full unpruned Bitcoin Core node and significant disk space
- Aimed at technical users; no graphical interface is described
- Does not validate consensus rules, so it depends on the integrity of the input data
- Supports only Bitcoin, limiting use for other chains
- Recent activity should be checked on the repository before relying on it for production work
Is Bitiodine safe?
Bitiodine is a read-only analysis tool, so it does not handle your keys or funds. Still, download it only from the official GitHub repository, verify the SHA-256 checksum or signature where available, and build it from source if you can. Never enter a seed phrase on any third-party website, whatever the tool or the site claims to offer.
Because the tool reads block files without verifying consensus rules, the main risk is analytical rather than financial: results from untrusted or inconsistent snapshots can be wrong. Always use a trusted chain tip and a complete snapshot, and check the repository's last update date before depending on the tool for important work.
- Official source only. Download from github.com/mikispag/bitiodine. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Bitiodine differs from many chain analysis options by running entirely on your own node and exposing its analysis as a programmable visitor interface. Hosted analytics platforms are easier to use but require you to trust their data and labels. Bitiodine asks more of you in setup and technical skill, but gives you full visibility into the input data and the logic applied to it.
Among the similar programs in this catalog, Dumplings also focuses on blockchain analysis, specifically CoinJoin detection, and is a narrower tool aimed at a particular privacy-related question. Bitiodine is more general: it is a framework for building your own heuristics over raw Bitcoin data. Your choice depends on whether you want a ready-made analysis or a foundation to build one.
Specifications
- Price
- Free
- Type
- Open source
- License
- MIT
- Latest version
- —
- Last update
- 4 Oct 2026
- Windows support
- Unverified (Windows mentioned in docs)
- Source code
- github.com/mikispag/bitiodine
Frequently asked questions
Yes. Bitiodine is distributed as free, open-source software under the MIT license. You can use, modify and redistribute it under the terms of that license. There is no price listed for the program itself, but running it requires a Bitcoin Core node, which takes storage and bandwidth.
The project lists Windows, macOS and Linux as platforms. However, the support status on Windows is not fully verified, and the documentation mentions Windows in general terms. Test the build in your own environment and check the repository for current guidance before relying on it.
Yes. The tool requires an unpruned Bitcoin Core node, because it reads the complete block files. A pruned node discards historical block data that the analysis needs, so it will not be sufficient for a full run.
The --chain-tip option tells Bitiodine which block is the trusted end of the chain you want to analyze. Block files can contain blocks outside the active chain, so specifying a tip you captured from bitcoin-cli ensures the analysis uses the branch you intended.
No. The project states that it analyzes trusted Bitcoin Core data and does not validate proof of work, scripts, difficulty transitions or the full consensus rules. It is designed for analysis, not for verifying that the chain is valid.
According to the documentation, Bitcoin (BTC) is the network it supports, and it targets Bitcoin Core mainnet data. It is not designed for other blockchains.
Yes. The pluggable BlockChainVisitor trait lets you implement custom analyzers, heuristics and indexers, and then run them from the command line without recompiling the core program.
Verdict
Bitiodine is a solid choice for technical users who want to run their own analysis over Bitcoin Core block data and need a clean, extensible framework for doing so. It is not a beginner-friendly explorer and requires a full node, but for researchers and developers who value control over their input data and analysis logic, it is a useful open-source foundation.