> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mibyanai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solana — Query Solana wallets, tokens, txs, and NFTs in USD

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

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

## Skill metadata

| | |
| - | - |
| Source | Optional — install with `mibyan skills install official/blockchain/solana` |
| Path | `optional-skills/blockchain/solana` |
| Version | `0.2.0` |
| Author | Deniz Alagoz (gizdusum), enhanced by Mibyan |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | `Solana`, `Blockchain`, `Crypto`, `Web3`, `RPC`, `DeFi`, `NFT` |

## Reference: full SKILL.md

<Info>
  The following is the complete skill definition that Mibyan loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
</Info>

# 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](https://api.mainnet-beta.solana.com)
Override: export SOLANA\_RPC\_URL=[https://your-private-rpc.com](https://your-private-rpc.com)

Helper script path: \~/.mibyan/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 theme={null}
python --version

# Optional: set a private RPC for better rate limits
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"

# Confirm connectivity
python ~/.mibyan/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 theme={null}
python ~/.mibyan/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 theme={null}
python ~/.mibyan/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 theme={null}
python ~/.mibyan/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 theme={null}
python ~/.mibyan/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 theme={null}
python ~/.mibyan/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 theme={null}
python ~/.mibyan/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 theme={null}
python ~/.mibyan/skills/blockchain/solana/scripts/solana_client.py stats
```

### 8. Price Lookup

Quick price check for any token by mint address or known symbol.

```bash theme={null}
python ~/.mibyan/skills/blockchain/solana/scripts/solana_client.py price BONK
python ~/.mibyan/skills/blockchain/solana/scripts/solana_client.py price JUP
python ~/.mibyan/skills/blockchain/solana/scripts/solana_client.py price SOL
python ~/.mibyan/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 theme={null}
# Should print current Solana slot, TPS, and SOL price
python ~/.mibyan/skills/blockchain/solana/scripts/solana_client.py stats
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.