Token logo API
GET/logos/:chain/:address
A token's logo as a small WebP, re-hosted by Aurelia so pages never load a deployer's server or an IPFS gateway. Use the URL the token endpoints give in logo.
Parameters
| Name | In | Type | Default | Allowed values |
|---|---|---|---|---|
chain | path | string | required | evm:56 (BSC), solana, evm:8453 (Base), evm:4663 (Robinhood Chain) or evm:1 (Ethereum) |
address | path | string | required | Token address (BSC) or mint (Solana) |
v | query | string | none | The logo's version, as in the logo URL |
Response
| Field | Type | Meaning |
|---|---|---|
(body) | image/webp | The token's image, fitted inside 256×256 and never enlarged; the first frame of an animated one. |
Example
Captured 2026-09-28 18:03 UTC on a test instance.
curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/logos/solana/So11111111111111111111111111111111111111112'{
"error": "no logo"
}Notes
- Open and not metered, so an
<img>can load it directly. Cache-Control: public, max-age=31536000, immutablewhenvnames the stored image; withoutv, or with an older one,max-age=3600. A new image gets a newv.404 {"error":"no logo"}when none is stored: the token's metadata has no image, it could not be fetched, or it was not fetched yet.