# Exploring Solana With Solscan

> Use this skill to query Solana blockchain data via the Solscan Pro API. Triggers: look up wallet address, check token price, analyze NFT collection, inspect transaction, explore DeFi activities, get account metadata/label/tags, fetch block info, monitor API usage, search token by keyword.

- Skill: `dvcrn/exploring-solana-with-solscan` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add dvcrn/exploring-solana-with-solscan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/exploring-solana-with-solscan/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/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)

```bash
export SOLSCAN_API_KEY=YOUR_SOLSCAN_API_KEY
```
**Or use `.env` file** (recommended for security):
```bash
cd exploring-solana-with-solscan
cp .env.example .env
# Edit .env with your credentials
nano .env
```

```http
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

| Action | Key Params | Returns |
|---|---|---|
| `account detail` | `--address` | Lamports, owner, executable flag |
| `account transfers` | `--address` | SPL + SOL transfer history |
| `account defi` | `--address` | DeFi protocol interactions |
| `account balance-change` | `--address` | Historical SOL balance changes |
| `account transactions` | `--address` | Recent transactions list |
| `account portfolio` | `--address` | Token holdings with USD value |
| `account tokens` | `--address` | Associated token accounts |
| `account stake` | `--address` | Active stake accounts |
| `account reward-export` | `--address` | Staking reward history CSV |
| `account transfer-export` | `--address` | Transfer history CSV |
| `account metadata` | `--address` | Label, icon, tags, domain, funder |
| `account metadata-multi` | `--addresses` | Batch metadata (comma-separated) |
| `account leaderboard` | — | Top accounts by activity |
| `account defi-export` | `--address` | DeFi activity CSV |

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

### Token

| Action | Key Params | Returns |
|---|---|---|
| `token meta` | `--address` | Name, symbol, decimals, supply |
| `token meta-multi` | `--addresses` | Batch metadata |
| `token price` | `--address` | Current USD price |
| `token price-multi` | `--addresses` | Batch prices |
| `token holders` | `--address` | Top holder list with amounts |
| `token markets` | `--address` | DEX markets trading this token |
| `token transfers` | `--address` | Transfer history |
| `token defi` | `--address` | DeFi activity |
| `token defi-export` | `--address` | DeFi activity CSV |
| `token historical` | `--address --type line` | Price history chart data |
| `token search` | `--query` | Search by keyword/name |
| `token trending` | — | Currently trending tokens |
| `token list` | — | Full token list |
| `token top` | — | Top tokens by market cap |
| `token latest` | — | Newly listed tokens |

### Transaction

| Action | Key Params | Returns |
|---|---|---|
| `transaction detail` | `--signature` | Full tx details |
| `transaction detail-multi` | `--signatures` | Batch tx details |
| `transaction last` | — | Most recent transactions |
| `transaction actions` | `--signature` | Human-readable decoded actions |
| `transaction actions-multi` | `--signatures` | Batch decoded actions |
| `transaction fees` | `--signature` | Fee breakdown |

### NFT

| Action | Key Params | Returns |
|---|---|---|
| `nft news` | — | Latest NFT activity feed |
| `nft activities` | `--address` | NFT transfer/sale history |
| `nft collections` | — | Top NFT collections |
| `nft items` | `--address` | Items inside a collection |

### Block

| Action | Key Params | Returns |
|---|---|---|
| `block last` | — | Most recent blocks |
| `block detail` | `--block` | Block metadata by slot number |
| `block transactions` | `--block` | All transactions in a block |

### Market

| Action | Key Params | Returns |
|---|---|---|
| `market list` | — | All trading pools/markets |
| `market info` | — | General market overview |
| `market volume` | — | 24h volume data |

### Program

| Action | Key Params | Returns |
|---|---|---|
| `program list` | — | All indexed programs |
| `program popular` | — | Most-used programs |
| `program analytics` | `--address` | Usage stats for a program |

### Monitor

| Action | Key Params | Returns |
|---|---|---|
| `monitor usage` | — | Your API key usage & rate limits |

---

## Error Handling

| HTTP Code | Meaning | Agent Action |
|---|---|---|
| `400` | Bad request / invalid address | Validate address format, retry |
| `401` | Authentication failed | Check `token` header is set correctly |
| `429` | Rate limit exceeded | Wait and retry with backoff |
| `500` | Internal server error | Retry once; report if persistent |

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

| Query | Expected Behavior |
|---|---|
| "What tokens does wallet `ABC123` hold?" | Calls `account portfolio --address ABC123`, returns token list with USD values |
| "What is the current price of BONK?" | Calls `token meta` to resolve mint, then `token price`, returns USD price |
| "Decode transaction `XYZ...`" | Calls `transaction actions --signature XYZ`, returns human-readable action list |
| "Is this a known wallet?" | Calls `account metadata --address`, returns label/tags/domain if available |

---

*Resources: [Solscan Pro API Docs](https://pro-api.solscan.io/pro-api-docs/v2.0)*