🌀

mycelium Friends API

myFriends are little mushroom characters that live fully on-chain. The collection was created to help bring Magic Forest to life, a real forest in Spain with an Art Hub at its heart.

This public API reads a verified blockchain snapshot and the locked artwork catalog. Public requests never trigger Ethereum RPC calls.

Meet the collection · Magic Forest · LLM reference · Health

Endpoints

GET/collectionCollection, contract, sale and supply. GET/traitsAll six trait families and their values. GET/myfriendsPaginated minted myFriends. GET/myfriend/1One myFriend and its resolved traits. GET/myfriend/1/metadataERC-721-style public metadata. GET/myfriend/1/image.svgExact SVG artwork rebuilt locally. GET/myfriend/1/image.pngSquare PNG on pure black. GET/wallet/0x…myFriends currently held by a wallet.

Try it

curl https://api.mycelium.magicforest.land/collection
curl https://api.mycelium.magicforest.land/myfriends?limit=20&offset=0
curl https://api.mycelium.magicforest.land/myfriend/1/image.svg

JSON responses include ETags and cache headers. Lists accept limit and offset. The API is display-only; Ethereum remains the source of truth.