Skip to content
GET /v1/resolve

Resolve a .eth name

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/ens-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/ens-api/v1/resolve" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/ens-api/v1/resolve", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/ens-api/v1/resolve");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/ens-api/v1/resolve",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "name": "vitalik.eth",
        "avatar": "https://euc.li/vitalik.eth",
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "records": {
            "pgp": "527E406252E06A11416D7487698FEAC70F922A21",
            "url": "https://vitalik.ca",
            "email": null,
            "github": "vbuterin",
            "reddit": null,
            "discord": null,
            "twitter": "VitalikButerin",
            "telegram": null,
            "description": "mi pinxe lo crino tcati"
        },
        "wallets": {
            "eth": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        },
        "resolver": "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63",
        "content_hash": "bafybeibbk35rvvgr7y7qynel2lc5s7fihuxvk23ubzzdyv3dpwgma3lahm",
        "primary_name": "vitalik.eth"
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:54.685Z",
        "request_id": "f60a3538-cd4a-4db4-88c7-82910fb291cc"
    },
    "status": "ok",
    "message": "Name resolved successfully",
    "success": true
}