List expiring ENS names
list_expiring_namesList ENS names that expire soon, soonest first, e.g. 'Which of nick.eth's names expire in the next 30 days?' or 'What names under ens.eth expire this month?'. Give address for one address's names (owned, managed or held through roles); then up to limit names come back in one answer, without a cursor. includeGrace adds names that already expired but are in their grace period, when they can still be renewed. Results come from an indexer and can lag the chain by a few blocks.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_expiring_names"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Items per page, 1 to 100. Default: 25 | |
| cursor | No | cursor from the previous page, to read the next one | |
| parent | No | Only direct subnames of this name; with no address only | |
| address | No | Ethereum address (0x…) or an ENS name resolving to one, e.g. nick.eth | |
| namespace | No | ens (default), or basenames for *.base.eth names on Base | |
| withinDays | No | Days ahead to look, 1 to 3650. Default: 30 | |
| includeGrace | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | End of the window searched | |
| asOf | No | Chain time the indexer's answer reflects | |
| from | Yes | Start of the window searched | |
| 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 |