SDK
- Setup
- TypeScript
- Checks
Endpoints
Reverse lookup of an Ethereum address to a primary name
Performs a reverse lookup of an Ethereum address
to a primary name.
Data sources for the primary name lookup include:
- The Ethereum Provider configured in the NameGuard instance.
- For ENS names using CCIP-Read: requests to externally defined gateway servers.
Returns display_name
to be shown to users and estimates impersonation_status
.
GET
/
secure-primary-name
/
{network_name}
/
{address}
Copy
Ask AI
curl --request GET \
--url https://api.nameguard.io/secure-primary-name/{network_name}/{address}
Copy
Ask AI
{
"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>"
}
}
Copy
Ask AI
curl --request GET \
--url https://api.nameguard.io/secure-primary-name/{network_name}/{address}
Path Parameters
Available options:
mainnet
, sepolia
Response
200
application/json
Successful Response
Reverse lookup result.
Copy
Ask AI
curl --request GET \
--url https://api.nameguard.io/secure-primary-name/{network_name}/{address}
Copy
Ask AI
{
"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>"
}
}
Assistant
Responses are generated using AI and may contain mistakes.