# mycelium Friends API

Base URL: https://api.mycelium.magicforest.land
Website: https://mycelium.magicforest.land

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 is a public, read-only API backed by a chain-verified persisted snapshot and the locked mainnet artwork catalog. API requests do not call Ethereum.

Endpoints:
- GET /health
- GET /collection
- GET /traits
- GET /myfriends?limit=50&offset=0
- GET /myfriend/{token_id}
- GET /myfriend/{token_id}/metadata
- GET /myfriend/{token_id}/image.svg
- GET /myfriend/{token_id}/image.png
- GET /wallet/{ethereum_address}?limit=50&offset=0

All token IDs are decimal integers. Wallets are 0x-prefixed Ethereum addresses. Lists use bounded offset pagination. The raw compatibility snapshot remains at https://magicforest.land/api/mycelium/snapshot.