List names of an address
list_names_for_addressList the ENS names of an address, e.g. 'What names does nick.eth own?'. By default lists names the address owns, manages or holds roles on; relation: resolvesTo lists names whose ETH address is the address, formerOwner names it used to own. Each name says how the address relates to it and whether it is the address's primary name. Set namespace to basenames for *.base.eth names. 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": {
"address": "<address>"
},
"name": "list_names_for_address"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 | |
| parent | No | Only direct subnames of this name, e.g. base.eth | |
| search | No | Only names whose label starts with this text | |
| address | Yes | Ethereum address (0x…) or an ENS name resolving to one, e.g. nick.eth | |
| relation | No | any (default: owner, manager or role holder), owner, manager, roleHolder, resolvesTo or formerOwner | |
| namespace | No | ens (default), or basenames for *.base.eth names on Base |
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 | |
| address | Yes | ||
| partial | No | Why the answer may be incomplete |