Introduction

Web3.py is a Python library for interacting with Ethereum.

It’s commonly found in decentralized apps (dapps) to help with sending transactions, interacting with smart contracts, reading block data, and a variety of other use cases.

The original API was derived from the Web3.js Javascript API, but has since evolved toward the needs and creature comforts of Python developers.

Getting Started

Your next steps depend on where you’re standing:

• Unfamiliar with Ethereum? → ethereum.org
• Looking for Ethereum Python tutorials? → ethereum.org/python
• Ready to code? → Quickstart
• Interested in a quick tour? → Overview
• Need help debugging? → StackExchange
• Like to give back? → Contribute
• Want to chat? → Discord
• Read the source? → Github

Table of Contents

Intro

• Quickstart
• Overview
• Release Notes

Guides

• Your Ethereum Node
• Providers
• Examples
• Troubleshooting
• Working with Local Private Keys
• Filtering
• Contracts
• ABI Types
• Middleware
• Web3 Internals
• ethPM
• Ethereum Name Service
• Migrating your code from v4 to v5
• Migrating your code from v3 to v4

API

• Web3 API
• web3.eth API
• Eth 2.0 Beacon API
• Package Manager API
• Net API
• Miner API
• Geth API
• Parity API
• Gas Price API
• ENS API
• Constants

Community

• Contributing
• Code of Conduct

Indices and tables

• Index
• Module Index
• Search Page