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.
/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>"
| Parameter | Description |
|---|---|
chainpath · 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. |
namepath · 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.
| Field | Type | Description |
|---|---|---|
name | string | The name, lowercase, ending ".eth". |
events | object[] | Every transaction that touched the name on this chain, newest first. Empty when none did. |
events[].txHash | string | The transaction, lowercase hex. |
events[].timestamp | string | When its block was produced, ISO 8601 UTC. |
events[].from | string | null | The address that sent the transaction. null when not stated. |
events[].action | string | null | The 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