获取以太坊地址在Kovan测试网络上挖矿的区块列表 API介绍

本API是以太坊区块浏览器Etherscan在Kovan测试网络上提供的一个查询特定以太坊地址在Kovan网络上已经挖出的区块的列表的RESTful API。本API需要提供有效的API Key才能使用。

API请求地址

https://api-kovan.etherscan.io/api

API请求参数

请求参数使用HTTP GET方法提交，并按照以下方式组织：

• module: 必选参数，固定值 "account"，表示查询账户信息模块；
• action: 必选参数，固定值 "getminedblocks"，表示查询指定账户已经挖掘的区块列表；
• address: 必选参数，表示要查询的以太坊地址；
• blocktype: 可选参数，默认值为 "blocks"，表示查询类型，取值为 "blocks" 或者 "uncles"；
• page: 可选参数，默认值为 1，表示要查询的分页页码；
• offset: 可选参数，默认值为 10，表示每页返回的区块个数，最大值为 10000；
• apikey: 必选参数，表示用户的API密钥，需要用户首先在Etherscan上注册并获得API密钥才能使用本API。

范例

下面是一个使用curl工具来查询以太坊地址 0x03801EfB0EFe2a25ede5Dd3a003Ae880C0292e4d在Kovan测试网络上挖掘的前10个区块的查询例子。其中需要将YourApiKeyToken替换成你的API Key。

curl -s "https://api-kovan.etherscan.io/api?module=account&action=getminedblocks&address=0x03801EfB0EFe2a25ede5Dd3a003Ae880C0292e4d&blocktype=blocks&page=1&offset=10&apikey=YourApiKeyToken"

返回结果

本API的返回结果是一个JSON对象，其中包括以下字段：

• status: 表示API调用的状态，取值为 "1" 或者 "0"，表示成功或者失败；

• message: 表示API返回的消息，如果调用失败，则此字段会包含失败的原因；

• result: 表示API返回的数据，是一个数组。数组的每个元素都是一个表示一个区块的JSON对象。每个JSON对象包括以下字段：

  • blockNumber: 表示区块的编号；
  • timestamp: 表示区块的时间戳；
  • blockReward: 表示区块奖励的以太币数量；
  • difficulty: 表示当前区块难度；
  • blockminer: 表示挖出该区块的矿工地址。

下面是一个返回结果的示例：

{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "26751667",
            "timeStamp": "1637051894",
            "blockReward": "3019057870000000000",
            "difficulty": "3107474973",
            "blockminer": "0x03801efb0efe2a25ede5dd3a003ae880c0292e4d"
        },
        {
            "blockNumber": "26751491",
            "timeStamp": "1637051342",
            "blockReward": "3018983900000000000",
            "difficulty": "3107482454",
            "blockminer": "0x03801efb0efe2a25ede5dd3a003ae880c0292e4d"
        },
        ......
    ]
}

以上为本API的介绍，希望对使用者有所帮助。