ENS name lookupENS name lookupReturns JSON with an ENS lookup on Ethereum in one call: the address of a name, the verified primary name of an address (reverse), the avatar and text records such as url, twitter and github.
Use when you need to resolve an ENS name to an address, reverse-resolve an address to its ENS name, or read an ENS avatar and profile records.
Do not use for registering or renewing names, or non-ENS naming such as Solana SNS.
Price: 0.005 USDC per call (x402, eip155:8453). Typical response time: 2000 ms (p95).
POST https://x402-gateway.blackwoodstate8.workers.dev/v1/ens-lookup. A request without payment gets 402 Payment Required with the
PAYMENT-REQUIRED header; any x402 client signs an EIP-3009 authorization and retries with
PAYMENT-SIGNATURE (or X-PAYMENT). Invalid input is answered with 400 and not charged.
curl -i -X POST https://x402-gateway.blackwoodstate8.workers.dev/v1/ens-lookup -H 'content-type: application/json' -d '{"name":"vitalik.eth"}'
| Pay to | 0x5B116BEdA1139452c12Ef0Cbc265c659B51b3526 |
|---|---|
| Asset | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC) |
| Amount | 5000 atomic units (0.005 USDC) |
| Authorization window | 60 s |
Streamable HTTP at https://x402-gateway.blackwoodstate8.workers.dev/mcp, tool blackwood_ens_lookup. Payment goes in
_meta["x402/payment"]; without it the tool returns the payment requirements.
| Field | Type | Meaning |
|---|---|---|
name (optional) | string | ENS name to resolve, e.g. vitalik.eth (send name or address, not both) |
address (optional) | string | Ethereum address to reverse-resolve, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 (send name or address, not both) |
texts (optional) | array | Text record keys to read (avatar, url, description, com.twitter, com.github and email when omitted), e.g. ["url", "com.github"] |
Example:
{
"name": "vitalik.eth"
}
Real example:
{
"name": "vitalik.eth",
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"primaryName": "vitalik.eth",
"avatar": "https://euc.li/vitalik.eth",
"avatarUrl": "https://euc.li/vitalik.eth",
"texts": {
"avatar": "https://euc.li/vitalik.eth",
"url": "https://vitalik.ca",
"description": "mi pinxe lo crino tcati",
"com.twitter": "VitalikButerin",
"com.github": "vbuterin",
"email": null
},
"resolver": "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63",
"chain": "ethereum",
"blockNumber": 26216461
}
{
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"primaryName": {
"type": [
"string",
"null"
]
},
"avatar": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"texts": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"null"
]
}
},
"resolver": {
"type": [
"string",
"null"
]
},
"chain": {
"type": "string",
"const": "ethereum"
},
"blockNumber": {
"type": "number"
},
"next": {
"type": "object",
"properties": {
"service": {
"type": "string",
"description": "Service id of the suggested next paid call"
},
"tool": {
"type": "string",
"description": "MCP tool name of the same call"
},
"method": {
"type": "string",
"enum": [
"GET",
"POST"
]
},
"url": {
"type": "string",
"description": "Paid route of the next call"
},
"useWhen": {
"type": "string",
"description": "When the next call is the right one"
},
"sample": {
"type": "string",
"description": "Free fixed sample of the whole family"
}
},
"required": [
"service",
"tool",
"method",
"url",
"useWhen",
"sample"
],
"additionalProperties": false,
"description": "Suggested next paid call in the same family (call it in a loop when the task continues)"
}
},
"required": [
"name",
"address",
"primaryName",
"avatar",
"avatarUrl",
"texts",
"resolver",
"chain",
"blockNumber"
],
"additionalProperties": false
}Free schema and example: GET https://x402-gateway.blackwoodstate8.workers.dev/v1/ens-lookup.
OpenAPI 3.1 · llms.txt · All services