Dataset guide 03
Bitcoin Address List Download
A Bitcoin address-list download should be easy to verify, resume and import without requiring proprietary software or an undocumented schema.
Choosing a file format
Plain TXT works well for one-value-per-line membership lists. TSV preserves explicit columns such as address, balance and script type while remaining easy to stream into PostgreSQL, ClickHouse, SQLite or command-line tools.
Gzip offers broad compatibility; Zstandard generally provides faster decompression and attractive compression ratios for repeated blockchain records. Binary and Bloom-filter formats serve performance-sensitive applications where human readability is less important.
Verify before importing
A checksum confirms that a downloaded file matches the published release. The manifest should also state the byte size, record count, generation timestamp, Bitcoin block height and block hash.
These details make interrupted downloads, stale mirrors and accidental file corruption detectable before a long database import begins.
Responsible use
Bitcoin addresses and balances are public protocol data, but interpretation requires care. An address is not a verified identity, and a downloaded list never contains private keys or a method for spending funds.
Frequently asked
Questions about bitcoin address list download
Can large downloads be resumed?
The planned delivery system supports HTTP range requests so compatible download tools can continue an interrupted transfer.
Will schemas be documented?
Yes. Each format is planned to include field definitions, units, supported script types and a versioned manifest.