Skip to main content

GET /domains/:owner

Return the reverse-resolved .sns domains owned directly or through domain NFTs by a wallet.

Request

GET /domains/:owner

Path parameters

owner

Required. The wallet's base58 public key.

Query parameters

rpc

Optional. A non-empty Solana RPC URL that overrides the proxy Worker's RPC_URL binding for this request.

Response

A successful request returns 200 OK with directly registry-owned entries followed by tokenized-domain entries:

type DomainsResponse = {
s: "ok";
result: Array<{
domain: string;
key: string;
}>;
};

domain is the fully qualified .sns name. key is its name-account public key. Subdomains and entries without reverse-name data are omitted.

Example

curl "https://sdk-proxy-v2.sns.id/domains/<OWNER_PUBLIC_KEY>"
{
"s": "ok",
"result": [
{
"domain": "name.sns",
"key": "<DOMAIN_ACCOUNT_PUBLIC_KEY>"
}
]
}

Errors

StatusresultWhen
400Invalid inputowner is not a valid Solana public key.
502RPC unavailableThe selected RPC returns a JSON-RPC error.
500Internal errorNo RPC is configured, or another failure occurs.