# blockchain-etl/ethereum-etl

Python scripts for ETL (extract, transform and load) jobs for Ethereum blocks, transactions, ERC20 / ERC721 tokens, transfers, receipts, logs, contracts, internal transactions. Data is available in Google BigQuery https://goo.gl/oY5BCQ

Repository: https://github.com/blockchain-etl/ethereum-etl
Canonical: https://ross.abutalabs.com/products/ethereum-etl
Homepage: https://t.me/BlockchainETL
Language: Python
License: MIT
License Family: permissive
Topics: ethereum, csv, export, erc20, erc20-tokens, etl, transaction, sql, aws, gcp, bigquery, google-cloud, erc721, blockchain-analytics
Last push: 2026-01-25T08:00:12+00:00

## Health v2 (maintenance only)
Score: 52/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 64, release rhythm 8, longevity 100
- inputs: {"age_days": 3045, "days_push": 220, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3127, forks 900 (observed 2026-08-28T04:07:44.493156+00:00)

## What it is
A Python CLI tool that extracts Ethereum blockchain data (blocks, transactions, token transfers, logs, traces, contracts) and exports it to CSV/JSON or loads it into relational databases and Google BigQuery. It also supports continuous streaming of new blockchain data.

## Use cases
- export ethereum blocks and transactions to csv
- extract erc20 and erc721 token transfers
- load ethereum blockchain data into bigquery
- stream new ethereum blocks in real time
- analyze smart contract events and logs
- export internal transactions and traces
- build a local relational database of ethereum data

## When to choose
- you need ethereum blockchain data in CSV, JSON, or SQL for analytics
- you want to replicate the public BigQuery ethereum dataset yourself
- you need batch or streaming extraction of blocks, token transfers, or traces
- you prefer a simple pip-installable CLI over running your own indexer

## When to avoid
- you need multi-chain support beyond Ethereum
- you need maximum extraction performance (consider the Rust rewrite ethereum-etl.rs)
- you want a hosted API rather than running extraction jobs yourself
- you need non-EVM chains like Solana or Bitcoin

## Facets
- artifact type: cli-tool
- maturity: active
- function: etl, cli, data-science, analytics
- domain: blockchain, analytics, big-data
- platform: python, cli, cross-platform, cloud
- tags: ethereum, blockchain-etl, erc20, erc721, bigquery, csv-export, blockchain-analytics, infura, cryptocurrency, data-engineering

## Member repositories
- blockchain-etl/ethereum-etl (main) score 52

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:44.493156+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:45:57.985296+00:00, confidence not recorded.
  - readme: https://github.com/blockchain-etl/ethereum-etl (fetched 2026-08-28T04:07:44.493156+00:00, sha 91ecdf33d2f3)
  - homepage: https://t.me/BlockchainETL (fetched 2026-08-29T09:41:10.360361+00:00, sha d18c27eb5c0a)
  - registry_pypi: https://pypi.org/pypi/ethereum-etl/json (fetched 2026-08-29T09:41:10.369971+00:00, sha 7298afd81d57)
- Data as of 2026-08-30T08:39:29.467469+00:00.