Query Solana blockchain data with USD pricing — wallet balances, token portfolios with values, transaction details, NFTs, whale detection, and live network stats. Uses Solana RPC + CoinGecko. No API key required.
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).
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 flag.
--no-pricesRPC 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
python3 solana_client.py wallet <address> [--limit N] [--all] [--no-prices]
python3 solana_client.py tx <signature>
python3 solana_client.py token <mint_address>
python3 solana_client.py activity <address> [--limit N]
python3 solana_client.py nft <address>
python3 solana_client.py whales [--min-sol N]
python3 solana_client.py stats
python3 solana_client.py price <mint_or_symbol>
python3 --version
# Optional: set a private RPC for better rate limits
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"
# Confirm connectivity
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats
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.).
python3 ~/.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.
Inspect a full transaction by its base58 signature. Shows balance changes in both SOL and USD.
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
tx 5j7s8K...your_signature_here
Output: slot, timestamp, fee, status, balance changes (SOL + USD), program invocations.
Get SPL token metadata, current price, market cap, supply, decimals, mint/freeze authorities, and top 5 holders.
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
token DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
Output: name, symbol, decimals, supply, price, market cap, top 5 holders with percentages.
List recent transactions for an address (default: last 10, max: 25).
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
activity 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM --limit 25
List NFTs owned by a wallet (heuristic: SPL tokens with amount=1, decimals=0).
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
nft 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
Note: Compressed NFTs (cNFTs) are not detected by this heuristic.
Scan the most recent block for large SOL transfers with USD values.
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
whales --min-sol 500
Note: scans the latest block only — point-in-time snapshot, not historical.
Live Solana network health: current slot, epoch, TPS, supply, validator version, SOL price, and market cap.
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats
Quick price check for any token by mint address or known symbol.
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price BONK
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price JUP
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price SOL
python3 ~/.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.
--no-prices for speed.token command for full info.# Should print current Solana slot, TPS, and SOL price
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats