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 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.
python3 --version
# Optional: set a private RPC for better rate limitsexport SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"# Confirm connectivity
python3 ~/.gauss/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.).
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
# Should print current Solana slot, TPS, and SOL price
python3 ~/.gauss/skills/blockchain/solana/scripts/solana_client.py stats