Get Single Subname

Usage

const subname = await client.getSingleSubname("alice.example.eth");

Returns null if the subname doesn’t exist.

Response Fields

object

Show properties

string

Unique identifier for the subname record.

string

Fully-qualified ENS name (e.g., alice.example.eth).

string

Parent ENS name.

string

Label portion of the subname (e.g., alice).

Record<string, string>

Text records associated with the subname.

Record<string, string>

Address records keyed by coin type (SLIP-44) or chain identifier.

Record<string, string>

Custom metadata key-value pairs.

string

Content hash if set.

string

ENS namehash of the subname.

string

Owner address, if present.

number

Optional TTL in seconds.

string

Creation timestamp (ISO 8601).

string

Last update timestamp (ISO 8601).

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"
}

Getting Started

How to Guides

Integrations

API Reference

SDK Reference

Architecture

Get Single Subname

Usage

Response Fields

Example Response

Notes

​Usage

​Response Fields

​Example Response

​Notes

Usage

Response Fields

Example Response

Notes