Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

GET /lookup/

Reverse lookup — resolve an Ethereum address to its claimed primary name.

Request

GET /lookup/0x11702b8eF5F882191Af862a7e27096C44A5e2B37

Response

{
    "address": "0x11702b8eF5F882191Af862a7e27096C44A5e2B37",
    "name": "kyy.web3",
    "reverseNode": "0x...",
    "verified": false
}

Fields

FieldTypeDescription
addressstringInput address (checksummed)
namestring | nullClaimed primary name, or null
reverseNodestringThe reverse node hash
verifiedbooleantrue if forward resolution of name returns this address

Errors

StatusBodyReason
400{ "error":" Name not found" }Name not found for current registered data
400{ "error": "Invalid Ethereum address" }Not a valid EVM address
404{ "error": "No reverse record found" }No reverse record set
429{ "error": "Rate limit exceeded" }Too many requests