{"uid":"cap_o23-2g85cggR4Ji3DFFSm","slug":"api-web3identity-com-43e7c057","name":"ENS Avatar Lookup","description":"Get avatar URL for ENS name or address","url":"https://api.web3identity.com/api/ens/avatar/ens.eth","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"name":"vitalik.eth"},"response":{"name":"ens.eth","avatar":"https://i.imgur.com/ga6y0c0.jpg","cached":false,"cachedAt":"2026-06-12T01:59:14.382Z","hasAvatar":true}},"exampleRequest":{"name":"vitalik.eth"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lMWe7mJn_Mgp51qXDbUY3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the avatar image URL associated with a given ENS name or Ethereum address","exampleAgentPrompt":"What's the avatar image URL for vitalik.eth? I want to display their ENS profile picture.","exampleUseCases":null,"resultDescription":"A URL pointing to the avatar image set in the ENS records for the given name or address — typically an IPFS link, HTTP URL, or NFT URI resolved to a usable image URL.","failureModes":["ENS name not found or not registered — returns 404 or null","No avatar record set for the ENS name — returns empty or null URL","Invalid ENS name format — returns 400 bad request","Ethereum address has no associated ENS primary name with avatar — returns null","IPFS or off-chain avatar resolution failure — returns error or broken URL"],"whenToPreferThis":"Use this endpoint when you need to display a profile picture or avatar image for an ENS name or Ethereum address — for example, in a Web3 social app, wallet UI, or identity card. Prefer this over general ENS resolution when you specifically need only the avatar URL rather than full ENS records.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:27.877Z","isFirstParty":false}