MintGarden

Browse and search Chia NFTs and collections, view stats, trade history, recent sales, trending data, and user profiles via MintGarden API.

Install
$clawhub install mintgarden

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

/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