POST
/
fake-eth-name-check
curl --request POST \
  --url https://api.nameguard.io/fake-eth-name-check \
  --header 'Content-Type: application/json' \
  --data '{
  "network_name": "mainnet"
  "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e"
  "token_id": "61995921128521442959106650131462633744885269624153038309795231243542768648193"
  "fields": {"title": "nick.eth"}
}'

{
  "status": "authentic_eth_name",
  "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>"
  },
  "investigated_fields": {}
}
curl --request POST \
  --url https://api.nameguard.io/fake-eth-name-check \
  --header 'Content-Type: application/json' \
  --data '{
  "network_name": "mainnet"
  "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e"
  "token_id": "61995921128521442959106650131462633744885269624153038309795231243542768648193"
  "fields": {"title": "nick.eth"}
}'

Body

application/json
​
network_name
enum<string>
required
Available options:
mainnet,
sepolia
​
contract_address
string
required

Contract address for the NFT contract (ERC721 and ERC1155 supported).

Examples:

"0x495f947276749ce646f68ac8c248420045cb7b5e"

​
token_id
string
required

The ID of the token (in hex or decimal format).

Examples:

"61995921128521442959106650131462633744885269624153038309795231243542768648193"

​
fields
object
required

Fields with values which will be investigated (e.g. title, collection name, metadata) whether they look like fake .eth ENS name. title key is mandatory, for ENS contracts it should be the ENS name.

Response

Successful Response

Fake .eth ENS name check result.

​
status
enum<string>
required
  • authentic_eth_name The NFT is associated with authentic ".eth" contracts.
  • impersonated_eth_name The NFT appears to impersonate a ".eth" name. It doesn't belong to authentic ENS contracts but contains graphemes that visually resemble ".eth" at the end of relevant NFT metadata fields. Consider automated rejection of this NFT from marketplaces.
  • potentially_impersonated_eth_name The NFT potentially impersonates a ".eth" name. It doesn't belong to authentic ENS contracts but contains graphemes that visually resemble ".eth" within relevant NFT metadata fields (but not at the end of those fields). Consider manual review of this NFT before publishing to marketplaces.
  • non_impersonated_eth_name The NFT doesn't represent itself as a ".eth" name and doesn't belong to authentic ENS contracts. No string that visually resembles ".eth" was found within relevant NFT metadata fields.
  • unknown_nft: No information could be found on the requested NFT. This generally indicates that the NFT doesn't exist or hasn't been indexed yet.
  • invalid_eth_name: The NFT is associated with authentic ".eth" contracts, but it is unnormalized.
  • potentially_authentic_eth_name: The NFT is associated with authentic ".eth" contracts, but its label is unknown.
  • unknown_eth_name: The NFT is associated with authentic ".eth" contracts, but its label is unknown or has never been registered.
Available options:
authentic_eth_name,
impersonated_eth_name,
potentially_impersonated_eth_name,
non_impersonated_eth_name,
unknown_nft,
invalid_eth_name,
unknown_eth_name
​
nameguard_result
object | null
required

NameGuard report for the .eth ENS NFT.

  • null if status is any value except authentic_eth_name, invalid_eth_name and unknown_eth_name (the NFT is not associated with authentic ".eth" contracts) Full name analysis result with information about individual checks and labels.
​
investigated_fields
object | null
required

Fields with values from Alchemy response which are investigated (e.g. title, collection name, metadata) whether they look like fake .eth ENS name.

  • null if status is unknown_nft