Endpoints

Inspect Labelhash GET

Inspects the name `[{labelhash}].{parent_name}`.

Parent may be a name with any number of labels. The default parent is “eth”.

This is a convenience endpoint to generate a NameGuardReport in cases when you only have:

The labelhash of the “childmost” label of a name.
The complete parent name of the “childmost” label.

NameGuard always inspects names, rather than labelhashes. So this endpoint will first attempt to resolve the “childmost” label associated with the provided labelhash through the ENS Subgraph, using the network specified in network_name.

If this label resolution fails the resulting NameGuardReport will be equivalent to requesting a NameGuardReport for the name [{labelhash}].{parent_name} which will contain (at least) one label with an unknown Normalization.

If this label resolution succeeds the resulting NameGuardReport will be equivalent to requesting a NameGuardReport for the name {label}.{parent_name}.

GET

inspect-labelhash

{network_name}

{labelhash}

{parent_name}

curl --request GET \
  --url https://api.nameguard.io/inspect-labelhash/{network_name}/{labelhash}/{parent_name}

{
  "rating": 3,
  "risk_count": 2,
  "highest_risk": {
    "check": "confusables",
    "status": 3,
    "message": "<string>",
    "check_name": "<string>"
  },
  "name": "vitalìk.eth",
  "namehash": "0xd48fd5598e605861cbd8e45419b41b83739bff52eaef0e283181bbe0a43a5b32",
  "normalization": "normalized",
  "checks": [
    {
      "check": "confusables",
      "status": 3,
      "message": "<string>",
      "check_name": "<string>"
    }
  ],
  "labels": [
    {
      "rating": 3,
      "risk_count": 2,
      "highest_risk": {
        "check": "confusables",
        "status": 3,
        "message": "<string>",
        "check_name": "<string>"
      },
      "label": "vitalìk",
      "labelhash": "0x41459971a5b847d0eef67bc11e2845f1074a2aed1ac6a357378b18fba50816e4",
      "normalization": "normalized",
      "checks": [
        {
          "check": "confusables",
          "status": 3,
          "message": "<string>",
          "check_name": "<string>"
        }
      ],
      "graphemes": [
        {
          "rating": 3,
          "risk_count": 2,
          "highest_risk": {
            "check": "confusables",
            "status": 3,
            "message": "<string>",
            "check_name": "<string>"
          },
          "normalization": "normalized",
          "grapheme": "v",
          "grapheme_name": "Latin Small Letter V",
          "grapheme_type": "simple_letter",
          "grapheme_script": "Latin",
          "grapheme_description": "A-Z letter",
          "title": "<string>",
          "subtitle": "<string>"
        }
      ],
      "canonical_label": "vitalik",
      "title": "<string>",
      "subtitle": "<string>",
      "beautiful_label": "<string>"
    }
  ],
  "canonical_name": "vitalik.eth",
  "title": "<string>",
  "subtitle": "<string>",
  "beautiful_name": "<string>"
}

curl --request GET \
  --url https://api.nameguard.io/inspect-labelhash/{network_name}/{labelhash}/{parent_name}

Path Parameters

network_name

enum<string>

required

Available options:

mainnet,

sepolia

labelhash

string

required

Labelhash should be a decimal or a hex (prefixed with 0x) string.

Examples:

"0x3276e4878615389906712b876ce1455b8f5d1c5ea3ffcf7a705e0d32fafae9c5"

parent_name

string

required

Parent name of the labelhash (default empty).

Examples:

"eth"

Response

200

application/json

Successful Response

Full name analysis result with information about individual checks and labels.

Inspect Namehash GET Reverse lookup of an Ethereum address to a primary name

curl --request GET \
  --url https://api.nameguard.io/inspect-labelhash/{network_name}/{labelhash}/{parent_name}

{
  "rating": 3,
  "risk_count": 2,
  "highest_risk": {
    "check": "confusables",
    "status": 3,
    "message": "<string>",
    "check_name": "<string>"
  },
  "name": "vitalìk.eth",
  "namehash": "0xd48fd5598e605861cbd8e45419b41b83739bff52eaef0e283181bbe0a43a5b32",
  "normalization": "normalized",
  "checks": [
    {
      "check": "confusables",
      "status": 3,
      "message": "<string>",
      "check_name": "<string>"
    }
  ],
  "labels": [
    {
      "rating": 3,
      "risk_count": 2,
      "highest_risk": {
        "check": "confusables",
        "status": 3,
        "message": "<string>",
        "check_name": "<string>"
      },
      "label": "vitalìk",
      "labelhash": "0x41459971a5b847d0eef67bc11e2845f1074a2aed1ac6a357378b18fba50816e4",
      "normalization": "normalized",
      "checks": [
        {
          "check": "confusables",
          "status": 3,
          "message": "<string>",
          "check_name": "<string>"
        }
      ],
      "graphemes": [
        {
          "rating": 3,
          "risk_count": 2,
          "highest_risk": {
            "check": "confusables",
            "status": 3,
            "message": "<string>",
            "check_name": "<string>"
          },
          "normalization": "normalized",
          "grapheme": "v",
          "grapheme_name": "Latin Small Letter V",
          "grapheme_type": "simple_letter",
          "grapheme_script": "Latin",
          "grapheme_description": "A-Z letter",
          "title": "<string>",
          "subtitle": "<string>"
        }
      ],
      "canonical_label": "vitalik",
      "title": "<string>",
      "subtitle": "<string>",
      "beautiful_label": "<string>"
    }
  ],
  "canonical_name": "vitalik.eth",
  "title": "<string>",
  "subtitle": "<string>",
  "beautiful_name": "<string>"
}

NameGuard

SDK

API

Inspect Labelhash GET

Inspects the name `[{labelhash}].{parent_name}`.

Path Parameters

Response