Get ENS name history
get_name_historyGet the history of an ENS name, newest first, e.g. 'When was nick.eth registered, renewed or transferred?'. Each event has its time, type, a one-line summary and its transaction. Filter by types (e.g. registration, renewal, transfer, resolver, record, migration) and a date range. Results come from an indexer and can lag the chain by a few blocks.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "get_name_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ENS name as the user wrote it, e.g. nick.eth; normalised by the server (ENSIP-15) | |
| limit | No | Items per page, 1 to 100. Default: 25 | |
| order | No | desc (default): newest first; asc: oldest first | |
| since | No | ||
| types | No | Only these event types | |
| until | No | ||
| cursor | No | cursor from the previous page, to read the next one |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | Chain time the indexer's answer reflects | |
| items | Yes | ||
| total | No | ||
| cursor | No | Pass back as cursor for the next page; absent on the last page | |
| partial | No | Why the answer may be incomplete |