Skip to main content
GET
/
secure-primary-name
/
{network_name}
/
{address}
curl --request GET \
  --url https://api.nameguard.io/secure-primary-name/{network_name}/{address}

{
  "primary_name_status": "normalized",
  "impersonation_status": "unlikely",
  "primary_name": "vitalik.eth",
  "display_name": "vitalik.eth",
  "nameguard_result": {
    "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/secure-primary-name/{network_name}/{address}

Path Parameters

​
address
string
required
​
network_name
enum<string>
required
Available options:
mainnet,
sepolia

Response

Successful Response

Reverse lookup result.

​
primary_name_status
enum<string>
required

The status of a secure primary ENS name lookup performed by NameGuard.

  • normalized: The ENS primary name was found and it is normalized.
  • no_primary_name: The ENS primary name was not found.
  • unnormalized: The ENS primary name was found, but it is not normalized.
Available options:
normalized,
no_primary_name,
unnormalized
​
impersonation_status
enum<string> | null
required

Impersonation status of the primary_name.

  • null if primary_name is null The predicted impersonation status of an ENS name.

  • unlikely: The ENS name is unlikely to be impersonating.

  • potential: The ENS name is potentially impersonating.

Available options:
unlikely,
potential
​
primary_name
string | null
required

Primary ENS name for the Ethereum address.

  • null if primary_name_status is any value except normalized
Examples:

"vitalik.eth"

​
display_name
string
required

ENS beautified version of primary_name.

  • if primary_name is null then provides a fallback display_name of "Unnamed [first four hex digits of Ethereum address]", e.g. "Unnamed c2a6"
Examples:

"vitalik.eth"

​
nameguard_result
object | null
required

NameGuard report for the primary_name.

  • null if primary_name_status is no_primary_name (primary name is not found) Full name analysis result with information about individual checks and labels.