English | 中文

etherscan-api

Golang client for the Etherscan.io API(and its families like BscScan), with nearly full implementation(accounts, transactions, tokens, contracts, blocks, stats), full network support(Mainnet, Ropsten, Kovan, Rinkby, Goerli, Tobalaba), and only depending on standard library. 😉

Usage

go get github.com/nanmu42/etherscan-api

Create an API instance and off you go. 🚀

import (
"github.com/nanmu42/etherscan-api""fmt"
)
funcmain() {
// create a API client for specified ethereum net// there are many pre-defined network in packageclient:=etherscan.New(etherscan.Mainnet, "[your API key]")
// or, if you are working with etherscan-family API like BscScan//// client := etherscan.NewCustomized(etherscan.Customization{// Timeout: 15 * time.Second,// Key: "You key here",// BaseURL: "https://api.bscscan.com/api?",// Verbose: false,// })// (optional) add hooks, e.g. for rate limitclient.BeforeRequest=func(module, actionstring, parammap[string]interface{}) error {
// ...
}
client.AfterRequest=func(module, actionstring, parammap[string]interface{}, outcomeinterface{}, requestErrerror) {
// ...
}
// check account balancebalance, err:=client.AccountBalance("0x281055afc982d96fab65b3a49cac8b878184cb16")
iferr!=nil {
panic(err)
}
// balance in wei, in *big.Int typefmt.Println(balance.Int())
// check token balancetokenBalance, err:=client.TokenBalance("contractAddress", "holderAddress")
// check ERC20 transactions from/to a specified addresstransfers, err:=client.ERC20Transfers("contractAddress", "address", startBlock, endBlock, page, offset)
}

You may find full method list at GoDoc.

Etherscan API Key

You may apply for an API key on etherscan.

The Etherscan Ethereum Developer APIs are provided as a community service and without warranty, so please just use what you need and no more. They support both GET/POST requests and a rate limit of 5 requests/sec (exceed and you will be blocked).

Paperwork Things

I am not from Etherscan and I just find their service really useful, so I implement this. 😄

License

Use of this work is governed by an MIT License.

You may find a license copy in project root.