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.eth
ensdata.net/0xd55Ab78034FcB6349830d0CfdFEFB6A8051d2685
ensdata.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.