etherscan-python

一个最小化且完整的针对Etherscan.io的Python API。

提供了所有标准和专业端点。支持Kovan、Rinkeby和Ropsten测试网。

可在PyPI上找到。由Etherscan.io API提供支持。

端点

以下提供了以下端点

如果您认为缺少了一个新添加的方法，请友好地打开一个 问题 作为功能请求，我会尽力添加。

安装

在继续之前，您应在 Etherscan.io 上注册一个账户并 生成一个个人API密钥 以供使用。

如果您希望访问PRO端点，您应通过Etherscan的订阅服务获得提升权限。

从源安装

pip install git+https://github.com/pcko1/etherscan-python.git

或者，从 PyPI 安装

pip install etherscan-python

单元测试

在 bash 中，在继续之前使用您的 YOUR_API_KEY（不带引号）测试一切是否正常

bash run_tests.sh YOUR_API_KEY

这将在 logs/ 下重新生成日志，包括最新的结果和执行时间戳。

测试还包括PRO端点，所以如果您的密钥不是PRO，相应的测试可能会失败。

用法

在 python 中，使用您的个人 Etherscan.io API密钥创建一个客户端

from etherscan import Etherscan
eth = Etherscan(YOUR_API_KEY) # key in quotation marks

然后您可以调用所有可用的方法，例如。

eth.get_eth_balance(address="0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a")

> '40891631566070000000000'

您也可以选择其他测试网

eth = Etherscan(YOUR_API_KEY, net="ropsten") # net name is case-insensitive, default is main

示例

所有方法的示例（参数和结果）可以作为JSON文件在此处找到 这里。例如，如果您想使用方法 get_block_number_by_timestamp，您可以在其各自的 JSON文件 中找到支持的参数及其输出格式

{
  "method": "get_block_number_by_timestamp",
  "module": "blocks",
  "kwargs": {
    "timestamp": "1578638524",
    "closest": "before"
  },
  "log_timestamp": "2020-10-28-12:34:44",
  "res": "9251482"
}

其中 kwargs 指的是必需的命名参数，res 指的是您运行时的预期结果

eth.get_block_number_by_timestamp(timestamp="1578638524", closest="before")

> '9251482'

免责声明：这些示例盲目使用原本在此处展示的参数，并且选择的钱包/合约不代表任何个人偏好。您应参考相同来源以获取有关特定参数值的其他信息。

问题

有关安装或使用软件包的问题，请打开一个 问题。请避免泄露可能敏感的信息，如您的API密钥或您的钱包地址。

引用

Kotsias, P. C., pcko1/etherscan-python. https://github.com/pcko1/etherscan-python (2020). doi:10.5281/zenodo.4306855

或者以 bibtex 格式

@misc{Kotsias2020,
  author = {Kotsias, P.C.},
  title = {pcko1/etherscan-python},
  year = {2020},
  publisher = {Zenodo},
  url = {https://github.com/pcko1/etherscan-python},
  doi = {10.5281/zenodo.4306855}
}

如果您觉得这个包很有用，请随意留下一个 :star:

由 Etherscan.io API 提供支持。