ENS text records (socials, avatar) API

Resolve an ENS name's address plus its text records — avatar, description, url, email, Twitter, GitHub, Telegram. Answers 'what's the twitter for this ENS name', 'get the avatar/socials for vitalik.eth', 'ENS profile'.

Price$0.01per request

MethodPOST

Route/v1/chain/ens-records

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache600s public

chainensrecordsavatartwitterprofilesocials

API URLhttps://x402.hexl.dev/v1/chain/ens-records

Integration docs

Example request

{
  "name": "vitalik.eth"
}

Example response

{
  "name": "vitalik.eth",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "records": {
    "com.twitter": "VitalikButerin",
    "url": "https://vitalik.ca"
  }
}

Input schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "examples": [
        "vitalik.eth"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "name",
    "records"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "address": {
      "type": [
        "string",
        "null"
      ]
    },
    "records": {
      "type": "object",
      "additionalProperties": true
    }
  }
}