Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Solana Blockchain Skill · nousresearch | DecimalAI

nousresearch/solana

SkillScore83Maintained

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

financeby nousresearch

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Data Analyst pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/nousresearch-solana/SKILL.md

decimalai skills pull nousresearch-solana --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/nousresearch-solana/SKILL.md https://app.decimal.ai/s/nousresearch-solana/SKILL.md

Raw file: /s/nousresearch-solana/SKILL.md ↗ · machine-readable summary at /s/nousresearch-solana.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

23 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 42d ago

—+29% tokens0% turns83% of whole cases pass with skill (19/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-04	✗→✓	▲ Improved	15%	0%
case-06	✗→✓	▲ Improved	43%	0%
case-07	✗→✓	▲ Improved	33%	0%
case-08	✗→✓	▲ Improved	8%	0%
case-09	✗→✓	▲ Improved	-3%	0%

Showing 5 of 23 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 8/17/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

nousresearch / hermes-agent

optional-skills/blockchain/solana/SKILL.md

View on GitHub ↗

License MITImported 8/17/2026Version v2Bundled 1 file · scripts

Skill contents

scripts/

SKILL.md

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 SOLANA_RPC_URL=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

bash
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.).

bash
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.

bash
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.

bash
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).

bash
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).

bash
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.

bash
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.

bash
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.

bash
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

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

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

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

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

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

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

Whale detector scans latest block only — not historical. Results

vary by the moment you query.

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

may not be available.

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

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

Retry on 429 — both RPC and CoinGecko calls retry up to 2 times

with exponential backoff on rate-limit errors.

Verification

bash
# Should print current Solana slot, TPS, and SOL price
python ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats

Illustrative Want to see what nousresearch/solana would put in front of your model? Preview the rendered body and check its trigger phrases — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/17/2026, 03:05 UTC · 23 cases

Measured on 20 comparable cases — below the 22 needed to publish a lift, so this result is shown here but not on the registry card or leaderboard.

Lift

+65%

83% vs 17%

Agent turns

0%

1.0 vs 1.0

Tokens

+29%

2,364.6 vs 1,838.9

fail → pass · 15pass → pass · 4fail → fail · 4

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 Can you check the Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM for me? I want to see its SOL balance, a breakdown of its token holdings with estimated USD valuations, and the total portfolio value.	fail→fail	4,332	4,116	-5%	1	1	0%	929	2,178	+134%	0	0	—
case-02 I'm keeping an eye on big market movements on Solana. Can you scan the current block for any major SOL transfers between wallets and summarize the largest transfers found?	fail→fail	7,667	6,100	-20%	1	1	0%	1,549	2,440	+58%	0	0	—
case-03 Could you fetch the current details for the token with mint address DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263? I need to know its total supply, current price, market cap, and who the top holders are.	fail→fail	6,526	8,340	+28%	1	1	0%	1,349	2,103	+56%	0	0	—
case-13 How do I look up the current price for token mint DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 using the price command?	pass→pass	6,287	2,504	-60%	1	1	0%	1,344	2,332	+74%	0	0	—
case-04 I need to quickly inspect all SPL token balances for address 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM without hitting CoinGecko rate limits or waiting for USD conversions. Which option should I pass to the client command?	fail→pass	10,882	2,766	-75%	1	1	0%	2,105	2,421	+15%	0	0	—
case-05 I want to list only the top 5 largest token positions for wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM. What argument regulates the maximum number of returned items?	fail→fail	6,819	3,083	-55%	1	1	0%	1,408	2,310	+64%	0	0	—
case-06 I need to view every single token account linked to wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM, including tiny dust balances without truncation. What flag forces showing all holdings?	fail→pass	9,060	6,325	-30%	1	1	0%	1,786	2,559	+43%	0	0	—
case-07 A user provided Solana transaction signature 5j7s8K9p123456789abcdef. What command dissects balance movements and program calls for this transaction?	fail→pass	8,624	2,121	-75%	1	1	0%	1,676	2,223	+33%	0	0	—
case-08 How can I request recent history for account 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM capped at 25 entries?	fail→pass	9,618	2,069	-78%	1	1	0%	2,097	2,275	+8%	0	0	—
case-09 How do I list non-fungible tokens owned by account 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM?	fail→pass	11,324	2,465	-78%	1	1	0%	2,395	2,326	-3%	0	0	—
case-10 I want to filter the current block for transfers exceeding 1000 SOL. What flag and parameter set that filter?	fail→pass	11,428	2,412	-79%	1	1	0%	2,059	2,198	+7%	0	0	—
case-11 What command shows live Solana performance stats including active epoch, current slot, and estimated TPS?	fail→pass	11,947	1,872	-84%	1	1	0%	2,063	2,097	+2%	0	0	—
case-12 How do I query the current price of BONK using the client tool?	fail→pass	6,029	1,517	-75%	1	1	0%	1,297	2,133	+64%	0	0	—
case-14 I am experiencing public RPC throttling. How can I redirect the script queries to a private endpoint at https://mainnet.helius-rpc.com/?api-key=123?	fail→pass	6,950	3,310	-52%	1	1	0%	1,550	2,502	+61%	0	0	—
case-15 Before running the Solana client script on a fresh system, which pip packages need to be installed via requirements.txt?	fail→pass	7,731	1,639	-79%	1	1	0%	1,426	2,104	+48%	0	0	—
case-16 Where should I paste my CoinGecko API key in the configuration before pulling token prices?	fail→pass	9,140	2,534	-72%	1	1	0%	1,961	2,325	+19%	0	0	—
case-17 Where is the solana_client.py executable script stored under the standard Hermes directory structure?	fail→pass	8,073	1,728	-79%	1	1	0%	1,572	2,110	+34%	0	0	—
case-18 Which major crypto tokens can be passed directly by ticker symbol rather than requiring a 44-character base58 mint address?	pass→pass	16,244	2,628	-84%	1	1	0%	2,704	2,294	-15%	0	0	—
case-19 Does the whale detector command scan the last 100 historical blocks to collect transfer records?	fail→pass	10,288	1,605	-84%	1	1	0%	1,699	2,076	+22%	0	0	—
case-20 How does the solana_client.py script filter regular SPL tokens from standard NFTs in a wallet?	pass→pass	12,177	7,479	-39%	1	1	0%	2,248	3,173	+41%	0	0	—
case-21 I want to query compressed NFTs (cNFTs) stored in wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM using solana_client.py nft. Will this command reveal my compressed collection?	pass→pass	9,219	2,826	-69%	1	1	0%	1,878	2,353	+25%	0	0	—
case-22 I need to look up a Solana transaction signature from 8 months ago using solana_client.py tx on default public RPC settings. Will public RPC nodes return this data?	fail→pass	8,506	4,962	-42%	1	1	0%	1,536	2,769	+80%	0	0	—
case-23 What command should I run with solana_client.py to send 2.5 SOL from my wallet to receiver 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM?	fail→pass	8,807	4,119	-53%	1	1	0%	1,974	2,712	+37%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 23 cases were attempted, and 20 counted toward the lift figure. The other 3 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +65 percentage points is the difference between those two pass rates over the 20 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 17.4%
Pass rate with the skill: 82.6%
Cases attempted: 23
Cases counted toward lift: 20
Cases that regressed: 0
Skill version measured: v2
Run completed: 8/17/2026, 03:05 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-04

Prompt

I need to quickly inspect all SPL token balances for address 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM without hitting CoinGecko rate limits or waiting for USD conversions. Which option should I pass to the client command?

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run83

Live evalNeeds ≥10 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+24% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 41 days ago

Model	Method	Date	Lift
gemini-3.6-flash	verified	8/8/2026	+73%

Other measured skills in the registry, with their headline benchmark lift.