List subnames
list_subnamesList the direct subnames of an ENS name, e.g. 'What subnames does ens.eth have?'. Expired subnames are left out unless includeExpired is set. 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": "list_subnames"
}
}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) | |
| sort | No | ||
| limit | No | Items per page, 1 to 100. Default: 25 | |
| order | No | ||
| cursor | No | cursor from the previous page, to read the next one | |
| search | No | Only subnames whose label starts with this text | |
| includeExpired | No |
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 |