Exploring Solana With Solscan

Solscan Pro Skill

Empowers AI agents to retrieve professional-grade Solana on-chain data across accounts, tokens, NFTs, transactions, blocks, markets, and programs.

When to Use This Skill

• User asks about a Solana wallet address, balance, portfolio, or stake
• User wants token price, holders, markets, or trending tokens
• User needs to inspect a transaction signature or decode instructions
• User asks about NFT collections, items, or recent NFT activity
• User wants DeFi activity, transfer history, or reward exports
• User wants to check program analytics or popular platforms

Prerequisites

Authentication

Private operations require API credentials and an Omni seed:

• SOLSCAN_API_KEY

All requests require an API key in the HTTP header:

Configuration

API Credentials (Required for Private Operations)

export SOLSCAN_API_KEY=YOUR_SOLSCAN_API_KEY

Or use .env file (recommended for security):

cd exploring-solana-with-solscan
cp .env.example .env
# Edit .env with your credentials
nano .env

token: <YOUR_SOLSCAN_API_KEY>

Base URL: https://pro-api.solscan.io/v2.0

Tools

Tool 1 — Direct API CLI (Precise Data)

Use when: you need exact, structured on-chain data for a specific address, signature, block, or mint.

Syntax: python3 scripts/solscan.py <resource> <action> [--param value]

Tool 2 — MCP Natural Language Tools

Use when: answering general exploratory questions or when the user does not provide a specific address.

Available MCP tools:

• search_transaction_by_signature — look up a transaction by its signature
• get_account_balance — retrieve SOL balance for a wallet
• get_token_metadata — get name, symbol, decimals for a token mint

API Reference

Account

account metadata response fields: account_address, account_label, account_icon, account_tags, account_type, account_domain, funded_by, tx_hash, block_time

Token

Transaction

NFT

Block

Market

Program

Monitor

Error Handling

All error responses include success: false, code, and message fields.

Example Workflows

Wallet Research Workflow

• Step 1: account metadata --address <ADDR> → confirm label and type
• Step 2: account portfolio --address <ADDR> → get token holdings
• Step 3: account transfers --address <ADDR> → review recent activity
• Step 4: account defi --address <ADDR> → check protocol interactions

Token Analysis Workflow

• Step 1: token meta --address <MINT> → confirm token identity
• Step 2: token price --address <MINT> → get current price
• Step 3: token holders --address <MINT> → check concentration risk
• Step 4: token markets --address <MINT> → find best liquidity pools

Evaluations

Resources: Solscan Pro API Docs