账号(Account)

账号及地址相关的 API，接口的参数说明请参考Etherscan API 约定, 文档中不单独说明。

获取单个账号余额

  1.  译者注:
  2.     英文 `balance` 有人翻译为`金额`，译者习惯称为`余额`。
  3.     账号和地址大部分也是指一个意思。

接口:

  1. /api?module=account&action=balance&address=0x&tag=latest&apikey=YourApiKeyToken

返回:

  1. {
  2.     status: "1",
  3.     message: "OK",
  4.     result: "40807178566070000000000"
  5. }

说明:

余额的单位都是最小单位wei， 更多单位换算可阅读：以太单位换算

请求样例URL，点击可在浏览器查看效果。

获取多个账号余额

接口:

  1. /api?module=account&action=balancemulti&address=0xabc,0x63..,0x198..&tag=latest&apikey=YourApiKeyToken

使用,来分割地址，一次请求最多20个账号。

返回：

  1. {
  2. status: "1",
  3. message: "OK",
  4. result: [
  5. {
  6. account: "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
  7. balance: "40807178566070000000000"
  8. },
  9. {
  10. account: "0x63a9975ba31b0b9626b34300f7f627147df1f526",
  11. balance: "332567136222827062478"
  12. }
  13. ]
  14. }

请求样例URL

获取地址(普通)交易列表

接口：

  1. /api?module=account&action=txlist&address=&apikey=YourApiKeyToken

可选参数：startblock 、endblock、sort

返回：

  1. {
  2.     "status": "1",
  3.     "message": "OK",
  4.     "result": [{
  5.         "blockNumber": "47884",
  6.         "timeStamp": "1438947953",
  7.         "hash": "0xad1c27dd8d0329dbc400021d7477b34ac41e84365bd54b45a4019a15deb10c0d",
  8.         "nonce": "0",
  9.         "blockHash": "0xf2988b9870e092f2898662ccdbc06e0e320a08139e9c6be98d0ce372f8611f22",
  10.         "transactionIndex": "0",
  11.         "from": "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
  12.         "to": "0x2910543af39aba0cd09dbb2d50200b3e800a63d2",
  13.         "value": "5000000000000000000",
  14.         "gas": "23000",
  15.         "gasPrice": "400000000000",
  16.         "isError": "0",
  17.         "txreceipt_status": "",
  18.         "input": "0x454e34354139455138",
  19.         "contractAddress": "",
  20.         "cumulativeGasUsed": "21612",
  21.         "gasUsed": "21612",
  22.         "confirmations": "7525550"
  23.     }]
  24. }

说明:

isError： 0= 没错, 1=出错 最多返回最近的10000个交易

返回字段中出现的关键字可参考以太坊设计与实现-术语。

请求样例URL

也可以使用分页，参数说明请参考Etherscan API 约定，分页请求样例URL

获取地址”内部”交易列表

内部交易只指引一个正常（外部）交易（连带）触发的交易，比如过一个合约调用触发的内部交易。

接口：

  1. /api?module=account&action=txlistinternal&address=

可选参数：startblock 、endblock、sort

返回结果和普通交易列表JSON结构一样。

请求样例URL

获取地址ERC20转账交易列表

转账交易是通过Transfer事件来判定的。

接口：

  1. /api?module=account&action=tokentx&address=&contractaddress

说明： 可选参数：startblock 、endblock、contractaddress 、sort 可以通过参数contractaddress来指定某一个合约的交易。

返回和上面普通交易列表JSON结构一样。

请求样例：

  1. 使用普通地址请求ERC20转账列表
  2. 仅使用合约地址请求ERC20转账列表
  3. 同时使用普通地址和合约地址请求ERC20转账列表

获取地址所挖区块列表

接口：

  1. /api?module=account&action=getminedblocks&address=&blocktype=blocks

说明：blocktype 值为 blocks（仅显示主链块） 或 uncles （仅显示叔块） ， blocks为默认值

返回：

  1. {
  2. status: "1",
  3. message: "OK",
  4. result: [
  5. {
  6. blockNumber: "3462296",
  7. timeStamp: "1491118514",
  8. blockReward: "5194770940000000000"
  9. },
  10. {
  11. blockNumber: "2691400",
  12. timeStamp: "1480072029",
  13. blockReward: "5086562212310617100"
  14. }
  15. ]
  16. }

说明： blockReward ：区块奖励， 同样使用最小单位wei， 更多单位换算可阅读：以太单位换算

请求样例URL及分页请求