Python bindings to the API
Switch branches/tags
Nothing to show
Clone or download
corpetty Merge pull request #41 from Qwoyn/master
Created  Merged despite comment from @AndreMiras, this can be refactored, rather have the functionality first.  I do agree that your solution was an easier method.
Latest commit 18ee101 Sep 17, 2018

py-etherscan-api module

Build Status Join the chat at API python bindings


This module is written as an effort to provide python bindings to the API, which can be found at: If you are interacting with a contract on the Ropsten Testnet please use In order to use this, you must attain an Etherscan user account, and generate an API key.

In order to use the API, you must provide an API key at runtime, which can be found at the API website. If you'd like to use the provided examples without altering them, then the JSON file api_key.json must be stored in the base directory. Its format is as follows:

{ "key" : "YourApiKeyToken" }

with YourApiKeyToken is your provided API key token from


To install the package to your computer, simply run the following command in the base directory:

python install

Available bindings

Currently, only the following API modules are available:

  • accounts
  • contracts
  • stats
  • tokens
  • proxies

The remaining available modules provided by will be added eventually...

Available Networks

Currently, this works for the following networks:

  • Mainnet
  • Ropsten


All possible calls have an associated example file in the examples folder to show how to call the binding

These of course will be fleshed out with more details and explanation in time

Jupyter notebooks area also included in each directory to show all examples


  • Package and submit to PyPI
  • Add the following modules:
    • event logs
    • geth proxy
    • websockets
  • Add robust documentation
  • Add unit test suite
  • Add request throttling based on Etherscan's suggestions

Holla at ya' boy


ETH: 0x5E8047fc033499BD5d8C463ADb29f10f11165ed0