账号(Account)

优质

小牛编辑

126浏览

2023-12-01

账号及地址相关的 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，更多单位换算可阅读：以太单位换算

请求样例URL及分页请求