Skip to main content
GET
Get Native Balance for an Address

Authorizations

apikey
string
query
required

Enter your Etherscan API key, or set one up if you don't have one.

Query Parameters

chainid
string
required

Chain ID to query. For example, use 1 for Ethereum or 42161 for Arbitrum from our supported chains.

module
string
default:account
required

Set to account for this endpoint.

action
string
default:balance
required

Set to balance for this endpoint.

address
string
required

The address to query, like 0xfefefefefefefefefefefefefefefefefefefefe. To query multiple addresses in a single call, use the Get Native Balance for Multiple Addresses endpoint.

tag
string

Use latest for the last block number of the chain. Also accepts a specific block number in hex format, like 0x10d4f up to the last 128 blocks. For historical balances, use the Historical Balance endpoint.

Response

200 - application/json

Successful response

status
string

1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.

message
string

OK on success, otherwise an error description such as NOTOK. See common error messages.

result
string

Account balance in wei, the smallest unit of the chain's native token. Divide by 10^18 for the value in ether. Use the unit converter to convert between units.