AVATARIO

by Bario Entertainment System

API Documentation

This service was originally created for baes.app to display Bario Punks-inspired avatars for users who comment without ENS or Basename profile pictures, replacing empty silhouettes with generated pixel art.

The API is domain-restricted and won't work if you try to use it directly on your site. However, we'd be happy if you're interested in using it! Please reach out to us at @basebario to discuss integration possibilities.

Open Source & Vercel Ready

Fork and Create Your Own!

This project is 100% open source! You can fork it, customize it with your own NFT artwork layers, and deploy your own avatar generation service.

GitHub Repository

Fork, star, and contribute

Deploy on Vercel

One-click deployment

Quick Setup

1.Fork the repository or click "Deploy on Vercel"
2.Add your own artwork layers in public/layers/
3.Update domain whitelist for production
4.Deploy and start generating unique avatars!

Endpoint

GET https://avatario.baes.so/api/avatar/[address]

Parameters

addressstringrequired

Valid Ethereum address (0x...)

sizeintegeroptional

Avatar size in pixels (16-2048, default: 512)

Supported sizes: 16, 32, 64, 128, 256, 512, 1024, 2048

Response

Returns PNG image with headers:

Content-Type: image/png
Cache-Control: public, max-age=31536000, immutable

Examples

GET https://avatario.baes.so/api/avatar/0x742d35Cc6634C0532925a3b844Bc9e7595f0fEb1
GET https://avatario.baes.so/api/avatar/0x742d35Cc6634C0532925a3b844Bc9e7595f0fEb1?size=256

Test API