aioetherscan

EIP3091 compliant explorers (i.e. Etherscan.io API async Python (Cython) wrapper.

Features

API modules

Supports all API modules:

• Accounts
• Contracts
• Transactions
• Blocks
• Event logs
• GETH/Parity proxy
• Tokens
• Gas Tracker
• Stats

Also provides extra module, which supports:

• link helps to compose links to address/tx/etc
• contract helps to fetch contract data
• generators allows to fetch a lot of transactions without timeouts and not getting banned

Blockchains

Includes support for loading any blockchain supported by evm-chains-info through evm-chains-explorers. Just provide the blockchain chainId.

Installation

The module is available on the Ur github mirror.

To build locally just run

  lur \
    python-aioetherscan

Usage

On some explorers some methods require an API key.

import asyncio
import logging

from aiohttp_retry import ExponentialRetry
from asyncio_throttle import Throttler

from aioetherscan import Client

logging.basicConfig(format='%(asctime)s - %(message)s', level=logging.INFO)


async def main():
    throttler = Throttler(rate_limit=4, period=1.0)
    retry_options = ExponentialRetry(attempts=2)

    c = Client('YourApiKeyToken', throttler=throttler, retry_options=retry_options)

    try:
        print(await c.stats.eth_price())
        print(await c.block.block_reward(123456))

        address = '0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2'
        async for t in c.extra.generators.token_transfers(
                address=address,
                start_block=19921833,
                end_block=19960851
        ):
            print(t)
            print(c.extra.link.get_tx_link(t['hash']))

        print(c.extra.link.get_address_link(address))
    finally:
        await c.close()


if __name__ == '__main__':
    asyncio.run(main())

License

The module is released under the terms of the GNU Affero General Public License version 3.