Wallets API

What happened to this .eth name: registrations, renewals and transfers

The history of an ENS .eth name (Basenames included) on ETH or BASE: every transaction that touched it, newest first, with who sent it and which action it took.

GET/api/external/wallet-analysis/name-history/{chain}/{name}

What it returns

The history of an ENS name ending ".eth" (Basenames such as jesse.base.eth included) on the chain asked: every transaction that touched it, newest first, from its registration through renewals, transfers and changes to its records. name-resolution answers what the name points to now; this answers how it got there. ENS names registered on ETH have their history on ETH; Basenames on BASE. A name nobody registered, or one nothing touched on the chain asked, answers an empty events list. The name is case-insensitive.

Chains

  • Ethereum ETH
  • Base BASE

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/wallet-analysis/name-history/ETH/<name>"
Parameters
ParameterDescription
chain

path · string · required

The chain whose name service registered the name. ETH and BASE (.eth names) are served; SOL, BNB, STABLE, RHC and ARC return 400. CELO, ARB, OP and SCROLL return 400 here.
name

path · string · required

The on-chain name: on SOL a .sol name, e.g. "bonfida.sol" — the ".sol" suffix may be left off; the top-level name is case-insensitive, a subdomain label is matched as written. On ETH and BASE an ENS name ending ".eth", e.g. "vitalik.eth" or "jesse.base.eth", case-insensitive.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of What happened to this .eth name: registrations, renewals and transfers
FieldTypeDescription
namestringThe name, lowercase, ending ".eth".
eventsobject[]Every transaction that touched the name on this chain, newest first. Empty when none did.
events[].txHashstringThe transaction, lowercase hex.
events[].timestampstringWhen its block was produced, ISO 8601 UTC.
events[].fromstring | nullThe address that sent the transaction. null when not stated.
events[].actionstring | nullThe method the transaction called, e.g. register, renew, setAddr, transferFrom, multicall; its 4-byte selector (0x…) when the method is not known. null when not stated.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key