Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

name: solana 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 区块链技能

通过 CoinGecko 获取经过美元价格标注的 Solana 在链数据。 提供 8 种命令：钱包资产组合查询、代币信息查询、交易记录查询、活动动态查询、NFT 查询、大额转账检测、网络状态查询以及价格查询。

无需 API 密钥，仅使用 Python 标准库（urllib、json、argparse）即可运行。

适用场景

  • 用户需要查询 Solana 钱包余额、代币持有量或资产组合价值
  • 用户希望根据签名查看特定交易记录
  • 用户需要了解 SPL 代币的元数据、价格、发行量或主要持有者信息
  • 用户需要获取某个地址的最新交易历史
  • 用户需要查询某个钱包拥有的 NFT
  • 用户希望检测大额 SOL 转账行为（即识别大额转账者）
  • 用户需要了解 Solana 网络的健康状况、每秒交易处理量、当前纪元信息或 SOL 价格
  • 用户询问“BONK/JUP/SOL 的价格是多少？”

先决条件

该辅助脚本仅依赖 Python 标准库（urllib、json、argparse），无需任何外部包。

价格数据来自 CoinGecko 的免费 API（无需密钥，但每分钟请求次数有限，约为 10-30 次）。如需更快查询速度，可使用 --no-prices 参数。

快速参考

RPC 接口地址（默认）：https://api.mainnet-beta.solana.com 如需自定义地址，请执行：export SOLANA_RPC_URL=https://your-private-rpc.com

辅助脚本路径：~/.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>

操作步骤

0. 设置检查

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. 钱包资产组合

可查看SOL余额、以美元计价的SPL代币持有量、NFT数量以及整体资产总值。代币会按价值进行排序，已废弃的代币会被过滤掉，常见的代币还会标注其名称（如BONK、JUP、USDC等）。

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

标志选项：

  • --limit N — 显示前 N 个代币的信息（默认值：20）
  • --all — 显示所有代币信息，不进行“无用代币”过滤，且无数量限制
  • --no-prices — 跳过对 CoinGecko 的价格查询（速度更快，仅通过 RPC 实现）

输出内容包括：SOL 存款余额及其对应的美元价值、按价值排序的带价格的代币列表、无用代币数量统计、以及以美元计价的整体投资组合价值。

2. 交易详情

可通过 Base58 签名查看完整的交易信息，同时显示 SOL 和美元形式的资产余额变化情况。

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

输出内容包括：插槽信息、时间戳、费用、状态、余额变动情况（SOL及USD币种）、程序调用记录。

3. 代币信息

可获取SPL代币的元数据、当前价格、市值、供应量、小数位数、铸造/冻结权限，以及排名前五的持有者信息。

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

输出内容包括：名称、符号、小数位、供应量、价格、市值，以及占比最高的前5名持有者。

4. 最新动态

列出某个地址的近期交易记录（默认显示最近10笔，最多显示25笔）。

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

5. NFT资产组合

列出钱包所拥有的NFT列表（识别规则：代币类型为SPL，数量为1，小数位为0）。

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

注意：该检测规则无法识别压缩型非同质化代币（cNFT）。

6. 大额资金追踪器

扫描最新区块中涉及高价值美元金额的SOL大额转账记录。

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

注意：仅扫描最新的区块数据——属于时间点快照，不包含历史数据。

7. 网络统计信息

实时的 Solana 网络状态：当前时隙、时代周期、每秒交易量、货币供应量、验证节点版本、SOL 价格以及市值。

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

8. 价格查询

可通过代币的铸造地址或已知符号，快速查询任意代币的价格。

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

已知代币符号：SOL、USDC、USDT、BONK、JUP、WETH、JTO、mSOL、stSOL、PYTH、HNT、RNDR、WEN、W、TNSR、DRIFT、bSOL、JLP、WIF、MEW、BOME、PENGU。

常见问题

  • CoinGecko 请求速率限制 —— 免费套餐允许每分钟约 10–30 次请求。查询价格时每个代币需占用 1 次请求，因此拥有大量代币的钱包可能无法获取所有代币的价格。如需提升速度，可使用 --no-prices 参数。
  • 公共 RPC 请求速率限制 —— Solana 主网上的公共 RPC 会对请求数量进行限制。如需在生产环境中使用，建议将 SOLANA_RPC_URL 设置为私有端点（如 Helius、QuickNode、Triton）。
  • NFT 检测基于规则推测 —— 其判断标准为“数量=1 + 小数位=0”。经过压缩的 NFT（cNFT）以及 Token-2022 格式的 NFT 不会被识别出来。
  • 巨鲸检测仅扫描最新区块 —— 不会查看历史区块数据，因此检测结果会因查询时间不同而有所差异。
  • 交易历史记录 —— 公共 RPC 仅保留约 2 天的记录，更早的交易可能无法查询到。
  • 代币名称显示 —— 约有 25 种知名代币会直接显示其完整名称，其余代币则仅显示简写的发行地址。如需获取完整信息，请使用 token 命令。
  • 遇到 429 错误时会自动重试 —— 面对速率限制错误时，无论是 RPC 调用还是 CoinGecko 请求都会以指数退避策略最多重试 2 次。

验证

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