Skip to main content

GET /api/ens/avatar/{name}

Get ENS Avatar URL

Get the avatar URL for an ENS name.

Supports​

  • Direct URL avatars
  • NFT avatars (ERC-721, ERC-1155)
  • IPFS avatars (resolved to gateway)

Response​

Avatar URL ready to use in img tags.

Pricing​

  • $0.005 per request

Endpoint​

GET https://api.web3identity.com/api/ens/avatar/{name}

Parameters​

NameInTypeRequiredDescription
namepathstringâś…ENS name (e.g., vitalik.eth)

Example Request​

curl -s "https://api.web3identity.com/api/ens/avatar/:name" | jq

Responses​

200 Avatar URL for ENS name​

400 Bad Request - Invalid parameters or malformed request​

{
  "error": "Invalid parameter format",
  "code": "INVALID_PARAMETER"
}

402 Payment Required - Free tier exhausted​

{
  "example": "response"
}

404 Not Found - Resource does not exist​

{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}

429 Rate Limited​

{
  "example": "response"
}

500 Internal Server Error - Something went wrong on our end​

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

Auto-generated from OpenAPI spec