Resolves an ENS name into its addresses, text records, and content hash, with batch suppor
Resolves an ENS name into its addresses, text records, and content hash, with batch support up to 50 names and per-name chain scoping via interop addresses.
5000 (raw units)
price
16
calls / 30d
11
unique payers
2026-09-15
updated
Provider
api.justaname.id · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xc529edd6d47c60923902514c7c0b3993ae42c2ec",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"maxTimeoutSeconds": 60
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"ens": "vitalik.eth"
},
"type": "http"
},
"output": {
"example": {
"fullName": "vitalik.eth",
"records": {
"contentHash": {
"decoded": "ipns://k51qzi5uqu5dgox2z23r6e99oqency055a6xt92xzmyvpz8mwz5ycjavm0u2u8",
"protocolType": "ipns"
},
"texts": [
{
"key": "url",
"value": "https://vitalik.ca"
},
{
"key": "avatar",
"value": "eip155:1/erc721:0x..."
}
]
},
"resolvedAddress": {
"coinType": "60",
"value": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
},
"type": "json"
}
},
"input": {
"ens": "vitalik.eth"
},
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ens": {
"type": "string"
}
},
"title": "Input",
"type": "object"
},
"output": {
"fullName": "vitalik.eth",
"records": {
"contentHash": {
"decoded": "ipns://k51qzi5uqu5dgox2z23r6e99oqency055a6xt92xzmyvpz8mwz5ycjavm0u2u8",
"protocolType": "ipns"
},
"texts": [
{
"key": "url",
"value": "https://vitalik.ca"
},
{
"key": "avatar",
"value": "eip155:1/erc721:0x..."
}
]
},
"resolvedAddress": {
"coinType": "60",
"value": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fullName": {
"type": "string"
},
"records": {
"properties": {
"contentHash": {
"properties": {
"decoded": {
"type": "string"
},
"protocolType": {
"type": "string"
}
},
"type": "object"
},
"texts": {
"items": {
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"resolvedAddress": {
"properties": {
"coinType": {
"type": "string"
},
"value": {
"type": "string"
}
},
"type": "object"
}
},
"title": "Output",
"type": "object"
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {},
"bodyType": {
"type": "string"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE",
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"queryParams": {
"type": "object"
},
"type": {
"const": "http"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"additionalProperties": false,
"properties": {
"example": {},
"format": {
"type": "string"
},
"type": {
"enum": [
"json",
"text"
]
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.justaname.id/ens/v2/resolve" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.justaname.id/ens/v2/resolve");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.justaname.id/ens/v2/resolve")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/772.json, and this resource appears in /discovery/resources and /discovery/search.