ENS Data

Look up Ethereum Name Service text records for any address and get them back in convenient JSON format.

Is there an API?

Append the wallet address or ENS after ensdata.net, that’s it. You don’t need any API keys.

Example:

ensdata.net/lochie.ethensdata.net/0xd55Ab78034FcB6349830d0CfdFEFB6A8051d2685ensdata.net/πŸ‘½πŸ‘½πŸ‘½.eth

Is this free to use?

Yes, it’s free until it gets hammered so hard I’m gonna have to pay Alchemy hundreds of dollars.

If you wanna support the longevity of this project send some eth to ens.pug.eth

Can this API return an ENS if I give it a wallet address?

Yep, it will return the primary ENS associated with that address. Emoji + subdomains are supported.

What about those pesky EIP155:1/ERC721 NFT records?

When NFTs are detected, the response will include an additional key with an appended _url at the end which points to decentralized storage that hosts the image.

Example:

"cover": "eip155:1/erc721:0x1e4c...cfff/89"

will produce an extra field of

"cover_url": "https://gateway.pinata.cloud/ipfs/bafy...nsoe"

You can render that extra URL directly or do it yourself and set up your own data provider / CDN that handles the original NFT record.

How fresh is this data?

Records are cached for 48 hours. If you need this data to be more up to date, let me know on Twitter or Telegram and we can work something out.

Which networks are supported?

Only Ethereum Mainnet is supported right now.

How can I get notified about API changes?

Subscribe to this Telegram channel for development updates.

Or if you’re one of those weirdos that do not use Telegram, you can preview it on the web.