Spacescan Skill

Explore the Chia blockchain via Spacescan.io API.

What It Does

View blocks and transactions
Check address balances
Monitor network statistics
Search blockchain data
Track CAT tokens and NFTs
Get XCH price

⚠️ API Key Required

Spacescan requires an API key. Get yours at: https://www.spacescan.io/apis

Set the environment variable:

export SPACESCAN_API_KEY=your_key_here

Or add to your shell profile (~/.zshrc or ~/.bashrc):

echo 'export SPACESCAN_API_KEY=your_key_here' >> ~/.zshrc
source ~/.zshrc

Commands

All commands can be triggered via:

/scan <command> in Telegram
/spacescan <command> in Telegram
scan <command> in CLI
spacescan <command> in CLI

Blocks

/scan block latest          Get latest block
/scan block <height>        Get block by height
/scan block <hash>          Get block by hash
/scan blocks <start> <end>  Get block range

Transactions

/scan tx <id>               Get transaction details

Addresses

/scan address <addr>        Get address info
/scan address balance <a>   Get address balance
/scan address txs <addr>    Get recent transactions

Coins

/scan coin <id>             Get coin details

Network

/scan stats                 Network statistics
/scan network               Network info
/scan space                 Network space (EiB)
/scan mempool               Mempool status
/scan price                 XCH price

Tokens

/scan cats                  List CAT tokens
/scan cat <id>              Get CAT details

NFTs

/scan nft <id>              Get NFT details

Search

/scan search <query>        Search blockchain
/scan <long_hash>           Quick search

Agent Usage

const { handleCommand } = require('./skills/spacescan');

// Requires SPACESCAN_API_KEY environment variable
const output = await handleCommand('block latest');

API Client

const SpacescanAPI = require('./skills/spacescan/lib/api');
const api = new SpacescanAPI('your-api-key');

// Get latest block
const block = await api.getLatestBlock();

// Get address balance
const balance = await api.getAddressBalance('xch1...');

// Get network stats
const stats = await api.getNetworkStats();

// Search
const result = await api.search('xch1...');

Installation

cd skills/spacescan
npm install
chmod +x cli.js
npm link  # Makes 'scan' and 'spacescan' global

Configuration

Required: Set your API key

export SPACESCAN_API_KEY=your_key_here

Get your key at: https://www.spacescan.io/apis

Free tier available with rate limits.

Examples

Check latest block:

/scan block latest

Get address balance:

/scan address balance xch1...

Network stats:

/scan stats

XCH price:

/scan price

Support

Spacescan: https://www.spacescan.io
API Plans: https://www.spacescan.io/apis
Bug reports: File in skill repository

Spacescan