chaindl

Open-source Python library for on-chain blockchain data

View on GitHub

An open-source Python tool to fetch on-chain blockchain data with 10+ GitHub stars and growing community adoption.

Aug 30, 2025

GITHUB STARS

14

CONTRIBUTORS

TECH STACK

PythonPandasRequestsSelenium
chaindl Documentation Screenshot

Why chaindl?

Accessing on-chain cryptocurrency data for analysis can be challenging: most websites do not have API access or require expensive commercial licenses (e.g. Glassnode 800$+).

I built chaindl to solve this problem — a Python library that allows anyone to fetch historical blockchain data, with a single function call, completely free.

Feature
Chaindl
Other APIs
Manual
Free
Multi-source data
Easy integration
Fast setup

Usage

First, install chaindl via pip:

Terminal
$ pip install chaindl

Then, using chaindl is simple. Just import the library and call the download() function:

Python
import chaindl
df = chaindl.download("https://charts.checkonchain.com/btconchain/pricing/pricing_picycleindicator/pricing_picycleindicator_light.html")

For more advanced use cases and the full usage guide, see the documentation .

Star History for the repository dhruvan2006/chaindl

How it Works

chaindl employs intelligent web scraping techniques to extract blockchain data from multiple public sources. Here's the technical architecture:

URL Analysis

Automatically detects data source type using domain pattern matching and URL structure analysis.

Data Extraction

Uses Selenium for dynamic content and Requests for static data, with custom parsers for each source.

Data Processing

Normalizes timestamps, handles missing values, and converts data types for consistent output format.

DataFrame Output

Returns clean pandas DataFrame ready for analysis, visualization, and further processing.

Frequently Asked Questions

What data sources does chaindl support?

chaindl currently supports multiple popular blockchain data sources including CheckOnChain, ChainExposed, Woocharts, Cryptoquant, Bitbo Charts, Bitcoin Magazine Pro, Blockchain.com, Glassnode, The Block and Dune. The library automatically detects the source type and applies the appropriate scraping method. A comprehensive list can be found in the documentation.

Is chaindl really free to use?

Yes, chaindl is completely free and open-source under the MIT license. Unlike commercial APIs that charge hundreds of dollars per month, chaindl accesses publicly available data sources at no cost.

What blockchains are supported?

Currently, chaindl primarily focuses on Bitcoin and Ethereum data. Support for additional blockchains is planned for future releases based on community demand and data source availability.

How do I install and get started?

Simply install via pip with 'pip install chaindl', then import the library and use the download() function with any supported URL. Check the documentation for detailed examples and usage patterns.

What's the difference between chaindl and paid APIs?

While paid APIs offer guaranteed uptime and support, chaindl provides free access to the same underlying data. It's perfect for research, learning, and projects that don't require enterprise-level SLAs.

Can I contribute to the project?

Absolutely! chaindl is open-source and welcomes contributions. You can submit bug reports, feature requests, or pull requests on GitHub.

Next Project

AutomaticCar Project Screenshot

Automatic Car

A C++ application that automatically builds trading strategies by optimizing technical indicators using a genetic algorithm.

C++QtGenetic AlgorithmsQuantitative Analysis