Use getSingleSubname to fetch a single subname by its fully-qualified name.

​
Usage

const subname = await client.getSingleSubname("alice.example.eth");
Returns null if the subname doesn’t exist.

​
Response Fields

​
SubnameDTO
object

​
Example Response

{
  "id": "01J9Q4YF7V3M8K2P9N6D1R4T7C",
  "fullName": "alice.example.eth",
  "parentName": "example.eth",
  "label": "alice",
  "texts": { "name": "Alice", "url": "https://example.com" },
  "addresses": { "60": "0x1234567890abcdef1234567890abcdef12345678" },
  "metadata": { "sender": "0x1234567890abcdef1234567890abcdef12345678" },
  "contenthash": null,
  "namehash": "0xa9f0e1d2c3b4a5f6e8d9c0a1e2f6b7c2c3b9f5f7e8a1c3d7e1b2b3e6f2f6155f",
  "owner": "0x1234567890abcdef1234567890abcdef12345678",
  "ttl": 3600,
  "createdAt": "2025-08-21T12:34:56.000Z",
  "updatedAt": "2025-08-21T13:45:12.000Z"
}

​
Notes

  • Returns null when the subname cannot be found.
  • For bulk queries or filtering by owner, label, or metadata, see getFilteredSubnames.