账号(Account)¶
账号及地址相关的 API，接口的参数说明请参考Etherscan API 约定, 文档中不单独说明。
获取单个账号余额¶
注解
- 译者注:
英文 balance 有人翻译为`金额`，译者习惯称为`余额`。 账号和地址大部分也是指一个意思。
接口:
/api?module=account&action=balance&address=0x&tag=latest&apikey=YourApiKeyToken
返回:
{
status: "1",
message: "OK",
result: "40807178566070000000000"
}
说明:
余额的单位都是最小单位wei， 更多单位换算可阅读：以太单位换算
请求样例URL，点击可在浏览器查看效果。
获取多个账号余额¶
接口:
/api?module=account&action=balancemulti&address=0xabc,0x63..,0x198..&tag=latest&apikey=YourApiKeyToken
使用,来分割地址，一次请求最多20个账号。
返回：
{
status: "1",
message: "OK",
result: [
{
account: "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
balance: "40807178566070000000000"
},
{
account: "0x63a9975ba31b0b9626b34300f7f627147df1f526",
balance: "332567136222827062478"
}
]
}
请求样例URL
获取地址(普通)交易列表¶
接口：
/api?module=account&action=txlist&address=&apikey=YourApiKeyToken
可选参数：startblock 、endblock、sort
返回：
{
"status": "1",
"message": "OK",
"result": [{
"blockNumber": "47884",
"timeStamp": "1438947953",
"hash": "0xad1c27dd8d0329dbc400021d7477b34ac41e84365bd54b45a4019a15deb10c0d",
"nonce": "0",
"blockHash": "0xf2988b9870e092f2898662ccdbc06e0e320a08139e9c6be98d0ce372f8611f22",
"transactionIndex": "0",
"from": "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
"to": "0x2910543af39aba0cd09dbb2d50200b3e800a63d2",
"value": "5000000000000000000",
"gas": "23000",
"gasPrice": "400000000000",
"isError": "0",
"txreceipt_status": "",
"input": "0x454e34354139455138",
"contractAddress": "",
"cumulativeGasUsed": "21612",
"gasUsed": "21612",
"confirmations": "7525550"
}]
}
说明:
isError： 0= 没错, 1=出错 最多返回最近的10000个交易
返回字段中出现的关键字可参考以太坊设计与实现-术语。
请求样例URL
也可以使用分页，参数说明请参考Etherscan API 约定，分页请求样例URL
获取地址”内部”交易列表¶
内部交易只指引一个正常（外部）交易（连带）触发的交易，比如过一个合约调用触发的内部交易。
接口：
/api?module=account&action=txlistinternal&address=
可选参数：startblock 、endblock、sort
返回结果和普通交易列表JSON结构一样。
请求样例URL
获取地址ERC20转账交易列表¶
转账交易是通过Transfer事件来判定的。
接口：
/api?module=account&action=tokentx&address=&contractaddress
说明： 可选参数：startblock 、endblock、contractaddress 、sort
可以通过参数contractaddress来指定某一个合约的交易。
返回和上面普通交易列表JSON结构一样。
请求样例：
获取地址所挖区块列表¶
接口：
/api?module=account&action=getminedblocks&address=&blocktype=blocks
说明：blocktype 值为 blocks（仅显示主链块） 或 uncles （仅显示叔块） ， blocks为默认值
返回：
{
status: "1",
message: "OK",
result: [
{
blockNumber: "3462296",
timeStamp: "1491118514",
blockReward: "5194770940000000000"
},
{
blockNumber: "2691400",
timeStamp: "1480072029",
blockReward: "5086562212310617100"
}
]
}
说明：
blockReward ：区块奖励， 同样使用最小单位wei， 更多单位换算可阅读：以太单位换算