# MintGarden Skill Browse, search, and analyze Chia NFTs via the MintGarden API. ## What It Does - Search NFTs and collections - View collection stats, floor prices, trading volume - Track NFT ownership and trade history - Monitor recent sales and activity - Get trending collections and top traders - Access profiles and portfolios ## Commands All commands can be triggered via: - `\/mg ` in Telegram - `\/mintgarden ` in Telegram - `mg ` in CLI - `mintgarden ` in CLI ### Search ```bash \/mg search # Search everything \/mg search nfts "rare zombie" # Search NFTs only \/mg search collections "pixel" # Search collections only ``` ### Collections ```bash \/mg collections list # Top collections by volume \/mg collection # Collection details \/mg collection nfts # NFTs in collection \/mg collection stats # Collection statistics \/mg collection activity # Recent sales\/transfers ``` ### NFTs ```bash \/mg nft # NFT details \/mg nft history # Trade history \/mg nft offers # Active offers ``` ### Profiles ```bash \/mg profile # Profile details \/mg profile nfts # User's NFTs \/mg profile activity # User's recent activity ``` ### Events & Stats ```bash \/mg events # Recent global activity \/mg events # Collection-specific events \/mg stats # Global marketplace stats \/mg trending # Trending collections (24h) \/mg top collectors # Top collectors (7d) \/mg top traders # Top traders (7d) ``` ### Shortcuts ```bash \/mg col1abc... # Quick collection lookup \/mg nft1abc... # Quick NFT lookup \/mg did:chia:... # Quick profile lookup ``` ## Agent Usage When users ask about Chia NFTs, collections, or MintGarden: ```javascript const { handleCommand } = require('.\/skills\/mintgarden'); \/\/ Natural language → formatted response const output = await handleCommand('show me trending collections'); ``` The skill handles: - Command parsing and normalization - API calls with error handling - Formatted text output (CLI\/Telegram friendly) - Pagination for large results ## API Client For custom integrations, use the API client directly: ```javascript const MintGardenAPI = require('.\/skills\/mintgarden\/lib\/api'); const api = new MintGardenAPI(); \/\/ Search const results = await api.search('zombie'); const nfts = await api.searchNFTs('rare', { limit: 50 }); \/\/ Collections const collections = await api.getCollections({ sort: 'volume_7d' }); const collection = await api.getCollection('col1abc...'); const stats = await api.getCollectionStats('col1abc...'); \/\/ NFTs const nft = await api.getNFT('nft1abc...'); const history = await api.getNFTHistory('nft1abc...'); \/\/ Profiles const profile = await api.getProfile('username'); const profileNFTs = await api.getProfileNFTs('did:chia:...'); \/\/ Events const events = await api.getEvents({ limit: 20 }); const trending = await api.getTrending({ period: '24h' }); \/\/ Stats const globalStats = await api.getGlobalStats(); const topCollectors = await api.getTopCollectors({ period: '7d' }); ``` ## Installation ```bash cd skills\/mintgarden npm install chmod +x cli.js npm link # Makes 'mg' and 'mintgarden' global ``` ## Configuration No API key required — MintGarden API is public. Optional: Set custom base URL via environment: ```bash export MINTGARDEN_API_URL=https:\/\/api.mintgarden.io ``` ## Output Format All commands return plain text suitable for: - Terminal output (CLI) - Telegram messages - Discord messages - WhatsApp messages No markdown tables (for WhatsApp compatibility). ## Error Handling - Invalid IDs → Clear error message - API failures → Retry-friendly error - Network issues → Timeout after 30s - Empty results → Helpful "not found" message ## Limits - Default limit: 50 results per query - Max limit: 100 results per query - No rate limiting (MintGarden is generous) - Pagination available via API client ## Examples **Find rare NFTs in a collection:** ```bash \/mg collection nfts col1abc... ``` **Check floor price:** ```bash \/mg collection col1abc... ``` **See what's hot:** ```bash \/mg trending ``` **Track a specific NFT:** ```bash \/mg nft history nft1abc... ``` **Monitor marketplace:** ```bash \/mg events ``` ## Tips - Use shortcuts for quick lookups (paste IDs directly) - Collection IDs start with `col1` - NFT launcher IDs start with `nft1` - Profile DIDs start with `did:chia:` - Trending updates every hour - Volume stats use 7-day window by default ## Support - MintGarden API: https:\/\/api.mintgarden.io\/docs - Chia NFTs: https:\/\/mintgarden.io - Bug reports: File in skill repository