MintGarden

MintGarden Skill

Browse, search, and analyze Chia NFTs via the MintGarden API.

What It Does

Commands

All commands can be triggered via:

Search

/mg search               # Search everything
/mg search nfts "rare zombie"   # Search NFTs only
/mg search collections "pixel"  # Search collections only

Collections

/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

/mg nft            # NFT details
/mg nft history    # Trade history
/mg nft offers     # Active offers

Profiles

/mg profile           # Profile details
/mg profile nfts      # User's NFTs
/mg profile activity  # User's recent activity

Events & Stats

/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

/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:

const { handleCommand } = require('./skills/mintgarden');
// Natural language → formatted response
const output = await handleCommand('show me trending collections');

The skill handles:

API Client

For custom integrations, use the API client directly:

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

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:

export MINTGARDEN_API_URL=https://api.mintgarden.io

Output Format

All commands return plain text suitable for:

No markdown tables (for WhatsApp compatibility).

Error Handling

Limits

Examples

Find rare NFTs in a collection:

/mg collection nfts col1abc...

Check floor price:

/mg collection col1abc...

See what's hot:

/mg trending

Track a specific NFT:

/mg nft history nft1abc...

Monitor marketplace:

/mg events

Tips

Support

Find rare NFTs in a collection:

/mg collection nfts col1abc...

Check floor price:

/mg collection col1abc...

See what's hot:

/mg trending

Track a specific NFT:

/mg nft history nft1abc...

Monitor marketplace:

/mg events

No API key required — MintGarden API is public.

Optional: Set custom base URL via environment:

export MINTGARDEN_API_URL=https://api.mintgarden.io