solana skill

by NousResearch·NousResearch/hermes-agent·263k stars·MIT

Query Solana wallets, tokens, txs, and NFTs in USD.

A100/100content scan

Is the solana skill safe?

Clean: nothing in its files matched our rules. We read 2 files in the folder on 2026-10-25.

No findings.

Install the solana skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description.

git clone --depth 1 https://github.com/NousResearch/hermes-agent.git /tmp/hermes-agent
mkdir -p ~/.claude/skills
cp -r /tmp/hermes-agent/optional-skills/blockchain/solana ~/.claude/skills/solana

available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

Solana Blockchain Skill

Query Solana on-chain data enriched with USD pricing via CoinGecko. 8 commands: wallet portfolio, token info, transactions, activity, NFTs, whale detection, network stats, and price lookup.

No API key needed. Uses only Python standard library (urllib, json, argparse).

When to Use

User asks for a Solana wallet balance, token holdings, or portfolio value
User wants to inspect a specific transaction by signature
User wants SPL token metadata, price, supply, or top holders
User wants recent transaction history for an address
User wants NFTs owned by a wallet
User wants to find large SOL transfers (whale detection)
User wants Solana network health, TPS, epoch, or SOL price
User asks "what's the price of BONK/JUP/SOL?"

Prerequisites

The helper script uses only Python standard library (urllib, json, argparse). No external packages required.

Pricing data comes from CoinGecko's free API (no key needed, rate-limited to ~10-30 requests/minute). For faster lookups, use --no-prices flag.

Quick Reference

RPC endpoint (default): https://api.mainnet-beta.solana.com Override: export SOLANARPCURL=https://your-private-rpc.com

Helper script path: ~/.hermes/skills/blockchain/solana/scripts/solana_client.py

python solana_client.py wallet   <address> [--limit N] [--all] [--no-prices]
python solana_client.py tx       <signature>
python solana_client.py token    <mint_address>
python solana_client.py activity <address> [--limit N]
python solana_client.py nft      <address>
python solana_client.py whales   [--min-sol N]
python solana_client.py stats
python solana_client.py price    <mint_or_symbol>

Procedure

0. Setup Check

python --version

# Optional: set a private RPC for better rate limits
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"

# Confirm connectivity
python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats

1. Wallet Portfolio

Get SOL balance, SPL token holdings with USD values, NFT count, and portfolio total. Tokens sorted by value, dust filtered, known tokens labeled by name (BONK, JUP, USDC, etc.).

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

Flags:

--limit N — show top N tokens (default: 20)
--all — show all tokens, no dust filter, no limit
--no-prices — skip CoinGecko price lookups (faster, RPC-only)

Output includes: SOL balance + USD value, token list with prices sorted by value, dust count, NFT summary, total portfolio value in USD.

2. Transaction Details

Inspect a full transaction by its base58 signature. Shows balance changes in both SOL and USD.

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  tx 5j7s8K...your_signature_here

Output: slot, timestamp, fee, status, balance changes (SOL + USD), program invocations.

3. Token Info

Get SPL token metadata, current price, market cap, supply, decimals, mint/freeze authorities, and top 5 holders.

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  token DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

Output: name, symbol, decimals, supply, price, market cap, top 5 holders with percentages.

4. Recent Activity

List recent transactions for an address (default: last 10, max: 25).

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  activity 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM --limit 25

5. NFT Portfolio

List NFTs owned by a wallet (heuristic: SPL tokens with amount=1, decimals=0).

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  nft 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

Note: Compressed NFTs (cNFTs) are not detected by this heuristic.

6. Whale Detector

Scan the most recent block for large SOL transfers with USD values.

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  whales --min-sol 500

Note: scans the latest block only — point-in-time snapshot, not historical.

7. Network Stats

Live Solana network health: current slot, epoch, TPS, supply, validator version, SOL price, and market cap.

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats

8. Price Lookup

Quick price check for any token by mint address or known symbol.

python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price BONK
python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price JUP
python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price SOL
python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

Known symbols: SOL, USDC, USDT, BONK, JUP, WETH, JTO, mSOL, stSOL, PYTH, HNT, RNDR, WEN, W, TNSR, DRIFT, bSOL, JLP, WIF, MEW, BOME, PENGU.

Pitfalls

Price lookups use 1 request per token. Wallets with many tokens may not get prices for all of them. Use --no-prices for speed.

CoinGecko rate-limits — free tier allows ~10-30 requests/minute.

For production use, set SOLANARPCURL to a private endpoint (Helius, QuickNode, Triton).

Public RPC rate-limits — Solana mainnet public RPC limits requests.

NFTs (cNFTs) and Token-2022 NFTs won't appear.

NFT detection is heuristic — amount=1 + decimals=0. Compressed

vary by the moment you query.

Whale detector scans latest block only — not historical. Results

may not be available.

Transaction history — public RPC keeps ~2 days. Older transactions

show abbreviated mint addresses. Use the token command for full info.

Token names — ~25 well-known tokens are labeled by name. Others

More skills from NousResearch/hermes-agent

A1passwordSet up op CLI, sign in, and read or inject secrets.
A3-statement-modelBuild integrated IS/BS/CF financial workbooks in Excel.
AaccelerateRun PyTorch training across GPUs with minimal changes.
Cactual-setupSet up Actual Computer (actual.inc) inference in Hermes.
Aadversarial-ux-testRoleplay a hostile user to find and triage UX pain points.
Aagent-merge-conflict-arbiterNeutral arbiter for merge conflicts between two agents.
AagentmailUse when an agent needs AgentMail CLI email inboxes.
Aai-presenter-videoMake a verified AI presenter video from script + image.
AairtableAirtable REST API via curl. Records CRUD, filters, upserts.
AanatomyExplain an idea as an interactive isometric machine figure.
Cantigravity-cliOperate the Antigravity CLI (agy): plugins, auth, sandbox.
Aapple-notesManage Apple Notes via memo CLI: create, search, edit.

All agent skills → · MCP servers