--- name: solana-d6b383f69328 description: Query Solana wallets, tokens, txs, and NFTs in USD. version: 0.2.0 author: Deniz Alagoz (gizdusum), enhanced by Hermes Agent license: MIT platforms: [linux, macos, windows] metadata: hermes: tags: [Solana, Blockchain, Crypto, Web3, RPC, DeFi, NFT] related_skills: [] --- # 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
[--limit N] [--all] [--no-prices] python solana_client.py tx python solana_client.py token python solana_client.py activity
[--limit N] python solana_client.py nft
python solana_client.py whales [--min-sol N] python solana_client.py stats python solana_client.py price ``` --- ## 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 ``` --- Source attribution: NousResearch Original project: https://github.com/NousResearch/hermes-agent License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2026 Gabriel Moreira Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: NousResearch Original project: https://github.com/NousResearch/hermes-agent Attribution basis: Upstream repository explicitly recorded in package mirror path Fields of work: Data & Analytics, Development & Engineering, Marketing Roles: Data Analyst, Growth Marketer, ML / AI Engineer Specialties: API, Backend Tools: Coingecko, Solana Rpc Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: aeb024c4ede2b5678cc1ad5ba93103141e0ba18e68d17859efd6957d3b45239f