web3: A Python library for interacting with Ethereum
Project Links
Meta
Author: The Ethereum Foundation
Requires Python: >=3.8, <4
Classifiers
Development Status
- 5 - Production/Stable
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Natural Language
- English
Programming Language
- Python :: 3
- Python :: 3.8
- Python :: 3.9
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
web3.py
A Python Library for Interacting with Ethereum
web3.py allows you to interact with the Ethereum blockchain using Python, enabling you to build decentralized applications, interact with smart contracts, and much more.
- Python 3.8+ support
Installation
python -m pip install web3
Documentation
Get started in 5 minutes or take a tour of the library.
View the change log.
For additional guides, examples, and APIs, see the documentation.
Want to Help?
Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our guidelines for contributing, then check out issues that are labeled Good First Issue.
Questions on Implementation or Usage?
Join the conversation in the Ethereum Python Community Discord.
8.0.0b3
Apr 30, 2026
8.0.0b2
Apr 02, 2026
8.0.0b1
Dec 19, 2025
7.16.0
May 01, 2026
7.15.0
Apr 02, 2026
7.14.1
Feb 03, 2026
7.14.0
Oct 16, 2025
7.13.0
Aug 04, 2025
7.12.1
Jul 14, 2025
7.12.0
May 22, 2025
7.11.1
May 12, 2025
7.11.0
Apr 29, 2025
7.10.0
Mar 27, 2025
7.9.0
Mar 12, 2025
7.8.0
Feb 03, 2025
7.7.0
Jan 15, 2025
7.6.1
Dec 18, 2024
7.6.0
Nov 22, 2024
7.5.0
Nov 06, 2024
7.4.0
Oct 16, 2024
7.3.1
Oct 14, 2024
7.3.0
Sep 25, 2024
7.2.0
Aug 29, 2024
7.1.0
Aug 28, 2024
7.0.0
Aug 21, 2024
7.0.0b9
Aug 01, 2024
7.0.0b8
Jul 24, 2024
7.0.0b7
Jun 26, 2024
7.0.0b6
May 15, 2024
7.0.0b5
Apr 26, 2024
7.0.0b4
Apr 11, 2024
7.0.0b3
Mar 28, 2024
7.0.0b2
Mar 12, 2024
7.0.0b1
Feb 28, 2024
6.20.4
Feb 19, 2025
6.20.3
Aug 22, 2024
6.20.2
Aug 14, 2024
6.20.1
Jul 22, 2024
6.20.0
Jun 26, 2024
6.19.0
May 15, 2024
6.18.0
Apr 29, 2024
6.17.2
Apr 17, 2024
6.17.1
Apr 15, 2024
6.17.0
Apr 11, 2024
6.16.0
Mar 28, 2024
6.15.1
Feb 05, 2024
6.15.0
Jan 25, 2024
6.14.0
Jan 10, 2024
6.13.0
Dec 20, 2023
6.12.0
Dec 11, 2023
6.11.4
Nov 27, 2023
6.11.3
Nov 08, 2023
6.11.2
Oct 30, 2023
6.11.1
Oct 18, 2023
6.11.0
Oct 11, 2023
6.10.0
Sep 21, 2023
6.9.0
Aug 23, 2023
6.8.0
Aug 02, 2023
6.7.0
Jul 26, 2023
6.6.1
Jul 12, 2023
6.6.0
Jul 12, 2023
6.5.0
Jun 15, 2023
6.4.0
May 15, 2023
6.3.0
May 03, 2023
6.2.0
Apr 12, 2023
6.1.0
Apr 05, 2023
6.0.0
Mar 14, 2023
6.0.0b11
Feb 24, 2023
6.0.0b10
Feb 15, 2023
6.0.0b9
Jan 03, 2023
6.0.0b8
Nov 14, 2022
6.0.0b7
Oct 19, 2022
6.0.0b6
Sep 26, 2022
6.0.0b5
Sep 19, 2022
6.0.0b4
Jul 13, 2022
6.0.0b3
Jun 01, 2022
6.0.0b2
Apr 27, 2022
6.0.0b1
Feb 28, 2022
5.31.4
Mar 13, 2023
5.31.3
Dec 02, 2022
5.31.2
Dec 01, 2022
5.31.1
Oct 06, 2022
5.31.0
Sep 19, 2022
5.30.0
Jul 07, 2022
5.29.2
Jun 01, 2022
5.29.1
May 16, 2022
5.29.0
Apr 13, 2022
5.28.0
Feb 09, 2022
5.27.0
Jan 31, 2022
5.26.0
Jan 06, 2022
5.25.0
Nov 19, 2021
5.24.0
Sep 27, 2021
5.23.1
Aug 27, 2021
5.23.0
Aug 12, 2021
5.22.0
Aug 02, 2021
5.21.0
Jul 12, 2021
5.20.1
Jul 01, 2021
5.20.0
Jun 09, 2021
5.19.0
Apr 28, 2021
5.18.0
Apr 09, 2021
5.17.0
Feb 24, 2021
5.16.0
Feb 04, 2021
5.15.0
Jan 15, 2021
5.14.0
Jan 05, 2021
5.13.1
Dec 03, 2020
5.13.0
Oct 29, 2020
5.12.3
Oct 21, 2020
5.12.2
Oct 12, 2020
5.12.1
Sep 02, 2020
5.12.0
Jul 20, 2020
5.12.0b3
Jul 15, 2020
5.12.0b2
Jul 14, 2020
5.12.0b1
Jul 09, 2020
5.11.1
Jun 17, 2020
5.11.0
Jun 03, 2020
5.10.0
May 18, 2020
5.9.0
Apr 30, 2020
5.8.0
Apr 23, 2020
5.7.0
Mar 16, 2020
5.6.0
Feb 26, 2020
5.5.1
Feb 10, 2020
5.5.0
Feb 03, 2020
5.4.0
Dec 06, 2019
5.3.1
Dec 05, 2019
5.3.0
Nov 14, 2019
5.2.2
Oct 21, 2019
5.2.1
Oct 17, 2019
5.2.0
Sep 26, 2019
5.1.0
Sep 18, 2019
5.0.2
Aug 22, 2019
5.0.1
Aug 15, 2019
5.0.0
Aug 01, 2019
5.0.0b5
Jul 31, 2019
5.0.0b4
Jul 18, 2019
5.0.0b3
Jul 15, 2019
5.0.0b2
May 13, 2019
5.0.0b1
May 06, 2019
5.0.0a11
Apr 24, 2019
5.0.0a10
Apr 15, 2019
5.0.0a9
Mar 26, 2019
5.0.0a8
Mar 20, 2019
5.0.0a7
Mar 11, 2019
5.0.0a6
Feb 25, 2019
5.0.0a5
Feb 13, 2019
5.0.0a4
Jan 23, 2019
5.0.0a3
Jan 15, 2019
5.0.0a2
Dec 20, 2018
5.0.0a1
Dec 13, 2018
4.10.0
Feb 05, 2020
4.9.2
Apr 24, 2019
4.9.1
Mar 26, 2019
4.9.0
Mar 25, 2019
4.8.3
Feb 21, 2019
4.8.2
Nov 15, 2018
4.8.1
Oct 28, 2018
4.8.0
Oct 28, 2018
4.7.2
Sep 25, 2018
4.7.1
Sep 11, 2018
4.6.0
Aug 24, 2018
4.5.0
Jul 30, 2018
4.4.1
Jun 29, 2018
4.4.0
Jun 22, 2018
4.3.0
Jun 06, 2018
4.2.1
May 09, 2018
4.2.0
Apr 25, 2018
4.1.0
Apr 09, 2018
4.0.0
Apr 02, 2018
4.0.0b13
Mar 27, 2018
4.0.0b12
Mar 27, 2018
4.0.0b11
Mar 01, 2018
4.0.0b10
Feb 22, 2018
4.0.0b9
Feb 08, 2018
4.0.0b7
Jan 30, 2018
4.0.0b6
Jan 18, 2018
4.0.0b5
Dec 28, 2017
4.0.0b4
Dec 08, 2017
4.0.0b3
Dec 01, 2017
4.0.0b2
Nov 22, 2017
4.0.0b1
Nov 15, 2017
3.16.5
Feb 02, 2018
3.16.4
Dec 01, 2017
3.16.3
Nov 22, 2017
3.16.2
Oct 11, 2017
3.16.1
Oct 02, 2017
3.16.0
Oct 02, 2017
3.15.0
Sep 20, 2017
3.14.2
Sep 18, 2017
3.14.1
Sep 18, 2017
3.14.0
Sep 18, 2017
3.13.5
Sep 06, 2017
3.13.4
Aug 29, 2017
3.13.3
Aug 28, 2017
3.13.2
Aug 24, 2017
3.13.1
Aug 24, 2017
3.13.0
Aug 24, 2017
3.11.1
Aug 09, 2017
3.11.0
Jul 26, 2017
3.10.0
Jul 18, 2017
3.9.0
Jul 07, 2017
3.8.1
May 01, 2017
3.8.0
Mar 22, 2017
3.7.2
Feb 27, 2017
3.7.1
Feb 22, 2017
3.7.0
Feb 21, 2017
3.6.2
Feb 15, 2017
3.6.1
Feb 14, 2017
3.6.0
Feb 06, 2017
3.5.3
Feb 03, 2017
3.5.2
Jan 19, 2017
3.5.1
Jan 11, 2017
3.5.0
Jan 11, 2017
3.4.4
Jan 01, 2017
3.4.3
Dec 31, 2016
3.4.2
Dec 30, 2016
3.4.1
Dec 29, 2016
3.4.0
Dec 29, 2016
3.3.0
Dec 28, 2016
3.2.0
Oct 24, 2016
3.1.1
Oct 12, 2016
3.1.0
Oct 10, 2016
3.0.2
Oct 06, 2016
3.0.1
Oct 03, 2016
3.0.0
Sep 30, 2016
2.9.0
Sep 24, 2016
2.8.1
Sep 12, 2016
2.8.0
Sep 10, 2016
2.7.1
Sep 08, 2016
2.7.0
Sep 07, 2016
2.6.0
Sep 07, 2016
2.5.0
Sep 06, 2016
2.4.0
Sep 06, 2016
2.3.0
Sep 05, 2016
2.2.0
Sep 03, 2016
2.1.1
Aug 31, 2016
2.1.0
Aug 30, 2016
2.0.0
Aug 19, 2016
1.9.0
Aug 16, 2016
1.8.0
Aug 15, 2016
1.7.1
Aug 15, 2016
1.7.0
Aug 13, 2016
1.6.0
Aug 08, 2016
1.5.0
Aug 07, 2016
1.4.0
Jul 27, 2016
1.3.0
Jul 16, 2016
1.2.0
Jul 15, 2016
1.1.0
Jul 14, 2016
1.0.1
Jul 13, 2016
1.0.0
Jul 11, 2016
0.1.9
May 04, 2016
0.1.8
May 04, 2016
0.1.7
Apr 28, 2016
Wheel compatibility matrix
Files in release
Extras:
Dependencies:
eth-abi
(>=5.0.1)
eth-account
(>=0.13.6)
eth-hash[pycryptodome]
(>=0.5.1)
eth-typing
(>=5.0.0)
eth-utils
(>=5.0.0)
hexbytes
(>=1.2.0)
aiohttp
(>=3.7.4.post0)
pydantic
(>=2.4.0)
pywin32
(>=223)
requests
(>=2.23.0)
typing-extensions
(>=4.0.1)
types-requests
(>=2.0.0)
websockets
(<16.0.0,>=10.0.0)
pyunormalize
(>=15.0.0)