Practical overview
When it fits
Use Ethereum ETL when a project needs programmable extraction and transformation of Ethereum data, including file exports, warehouse loading or ongoing streaming. If the immediate task is querying an existing public dataset, the project points to Ethereum data in Google BigQuery.
Who it is for
- Developers building Ethereum data pipelines
- Analysts working with blockchain exports
- Teams creating token, contract or transaction data warehouses
- Users querying Ethereum data through BigQuery or related data tools
Documented uses
- Export blocks and transactions for a selected range
- Create ERC-20 and ERC-721 transfer datasets
- Process receipts, logs, contracts, traces and internal transactions
- Stream selected Ethereum data continuously
- Prepare data for BigQuery, relational databases or file-based analysis
Requirements & limits
The documented service is accessed through a public GitHub repository and command-line tooling. The project is open source under the MIT license. No account or pricing requirement is documented in the supplied material.
- It is Python-based and operated through command-line commands.
- Provider or node access is required by the documented export examples.
- The output options include CSV, relational data and Google BigQuery datasets.
- Docker workflows are documented for export and streaming jobs.
- The project covers both historical range exports and continual streaming.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Export Ethereum blocks and transactions to CSV
Create CSV files for blocks and transactions across a specified Ethereum block range.
Before you start
- Python package installation with pip3
- An Ethereum provider URI
- A selected start and end block
Steps
Install Ethereum ETL with pip3.
Run the documented export_blocks_and_transactions command with the block range, output filenames and provider URI.
Use the resulting blocks.csv and transactions.csv files for analysis or downstream loading.
Expected outcome
A blocks CSV and a transactions CSV are produced for the selected range.
Guide limitations
- The documented command requires access to an Ethereum provider or node endpoint.
- The example covers block and transaction export only, not downstream analysis or database loading.
Build and run Ethereum ETL with Docker
Prepare a Docker image and run a documented export or streaming job.
Before you start
- Docker
- The Ethereum ETL repository
- An Ethereum provider URI for the documented export examples
Steps
Build the image with the documented docker build command.
Run a container with export_all and a selected block or date range, mounting an output directory when exporting files.
Alternatively, run the container's stream command to send data to the console or provide the documented Google Pub/Sub configuration.
Expected outcome
A Docker container runs an Ethereum export or streaming command using the project image.
Guide limitations
- The documented Docker examples require Docker and, for Pub/Sub streaming, a credentials file and Google application credentials configuration.
- The README notes an additional linux/x86_64 platform option for Apple M1 builds and runs.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 1 October 2026
- Original website title
- blockchain-etl/ethereum-etl · Official homepage title · retained in its source language