MintGarden Skill

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 <command> in Telegram
• /mintgarden <command> in Telegram
• mg <command> in CLI
• mintgarden <command> in CLI

Search

/mg search <query>              # 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 <id>             # Collection details
/mg collection nfts <id>        # NFTs in collection
/mg collection stats <id>       # Collection statistics
/mg collection activity <id>    # Recent sales/transfers

NFTs

/mg nft <launcher_id>           # NFT details
/mg nft history <launcher_id>   # Trade history
/mg nft offers <launcher_id>    # Active offers

Profiles

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

Events & Stats

/mg events                      # Recent global activity
/mg events <collection_id>      # 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:

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

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:

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

/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

• 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