Skip to main content
GET
Resolve an ENS Name to an Address
Ethereum
Available on Free and paid plans. Free users are limited to 1 call/second. Paid users follow their plan’s rate limit.

Supported Names

ENS names and subdomains, such as etherscan.eth or gm.etherscan.eth are supported.
Names that require offchain resolution following EIP-3668: CCIP Read & ENSIP-10: Wildcard Resolution, such as jesse.base.eth are not supported.
Results are cached for up to 5 mins, onchain name changes will reflect automatically after this period.

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. Use 1 for Ethereum mainnet. This endpoint is only available on Ethereum mainnet.

module
string
default:ens
required

Set to ens for this endpoint.

action
string
default:forwardresolve
required

Set to forwardresolve for this endpoint.

name
string
required

The ENS name to resolve, such as etherscan.eth or gm.etherscan.eth.

Response

200 - application/json

Successful response

status
string

1 on success, or 0 when the request fails.

message
string

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

result
string

The resolved Ethereum address on success.