Skip to main content
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_report": {
    "rating": 2,
    "risk_count": 123,
    "highest_risk": {
      "check": "normalized",
      "status": 0,
      "message": "<string>",
      "check_name": "<string>"
    },
    "name": "<string>",
    "namehash": "<string>",
    "normalization": "normalized",
    "inspected": true,
    "checks": [
      {
        "check": "normalized",
        "status": 0,
        "message": "<string>",
        "check_name": "<string>"
      }
    ],
    "labels": [
      {
        "rating": 2,
        "risk_count": 123,
        "highest_risk": {
          "check": "normalized",
          "status": 0,
          "message": "<string>",
          "check_name": "<string>"
        },
        "label": "<string>",
        "labelhash": "<string>",
        "normalization": "normalized",
        "checks": [
          {
            "check": "normalized",
            "status": 0,
            "message": "<string>",
            "check_name": "<string>"
          }
        ],
        "graphemes": [
          {
            "rating": 2,
            "risk_count": 123,
            "highest_risk": {
              "check": "normalized",
              "status": 0,
              "message": "<string>",
              "check_name": "<string>"
            },
            "normalization": "normalized",
            "grapheme": "<string>",
            "grapheme_name": "<string>",
            "grapheme_type": "<string>",
            "grapheme_script": "<string>",
            "grapheme_description": "<string>",
            "unicode_version": "15.0",
            "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).

Example:

"0x495f947276749ce646f68ac8c248420045cb7b5e"

​
token_id
string
required

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

Example:

"61995921128521442959106650131462633744885269624153038309795231243542768648193"

​
fields
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_report
NameGuardReport · object
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)
​
investigated_fields
Investigated Fields · object
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