本文原文鏈接
點擊這裏獲取Etherscan API 中文文檔(完整版)
完整內容排版更好,推薦讀者前往閱讀。
賬號(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
點擊獲取Etherscan API 中文文檔(完整版)
示意圖:
相關文檔推薦:
Solidity 中文文檔(完整版)
ethers.js 中文文檔(完整版)
Web3.js 中文文檔(完整版)
Truffle 中文文檔(完整版)