Introduction
You need a list of every wallet holding your Solana token. Maybe you're planning an airdrop, setting up a governance vote, or just analyzing your holder base.
The problem? Blockchain explorers don't let you export that data. APIs require coding. RPC queries are complex.
In this tutorial, I'll show you exactly how to take a token snapshot on Solana—no coding required—and export your complete holder list to CSV in under 60 seconds.
What You'll Need
Before starting, make sure you have:
- Token Mint Address — The unique identifier for your SPL or SPL22 token
- Web Browser — Any modern browser (Chrome, Firefox, Safari)
- 5 Minutes — That's all it takes
Don't have the mint address? Find it on Solscan, Birdeye, or DexScreener by searching your token name.
How to Take a Token Snapshot (Step-by-Step)
Step 1: Open the Token Snapshot Tool
Navigate to Jumpbit Token Snapshot.
No account or wallet connection required—the tool reads public blockchain data.
Step 2: Enter Your Token Mint Address
Paste your SPL or SPL22 token's mint address into the input field.
Example mint addresses:
- BONK:
DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 - USDC:
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
The tool validates the address and shows token metadata (name, symbol, decimals).
Step 3: Configure Snapshot Settings
Adjust optional settings:
| Setting | Description | Default |
|---|---|---|
| Max Holders | Limit results to top N holders | All |
| Min Balance | Exclude wallets below threshold | 0 |
| Export Format | CSV or JSON | CSV |
For most use cases, default settings work fine—capturing all holders.
Step 4: Generate the Snapshot
Click "Generate Snapshot" to start the process.
What happens next:
- The tool queries Solana RPC nodes
- It scans all token accounts for your mint
- Progress bar shows completion status
- Large tokens (100K+ holders) may take 30-60 seconds
Step 5: Download Your Holder List
Once complete, click "Download CSV" or "Download JSON".
Your file includes:
- Wallet addresses (holders)
- Token balances (raw and formatted)
- Percentage of total supply
- Holder rank
Understanding Your Snapshot Data
Here's what each column in your CSV means:
Wallet Address
The Solana public key of the holder. This is the address you'll use for:
- Airdrop distribution
- Whitelist verification
- Analytics tracking
Token Balance (Raw)
The on-chain balance as a raw integer. For a token with 9 decimals, a balance of 1000000000 equals 1.0 tokens.
Token Balance (UI Amount)
The human-readable balance with decimals applied. This is what you'd see in a wallet—1,000.50 tokens.
Percentage of Supply
The holder's share of total circulating supply. Useful for:
- Identifying whales (5%+ holders)
- Proportional airdrop calculations
- Supply concentration analysis
What to Do After Taking a Snapshot
For Airdrops
- Filter the list — Remove exchange wallets, known bots, or holders below minimum
- Calculate amounts — Add an "airdrop amount" column based on your distribution logic
- Import to Multisender — Upload to Jumpbit Multisender for bulk distribution
For Governance
- Set snapshot block — Note the timestamp/block when snapshot was taken
- Publish criteria — Announce minimum balance required to vote
- Verify eligibility — Cross-reference voter addresses against snapshot
For Analytics
- Save historical copies — Take weekly/monthly snapshots to track growth
- Calculate metrics — Holder count, average balance, Gini coefficient
- Visualize trends — Chart holder growth over time
How to Filter Your Snapshot Data
Raw snapshots include everything—including wallets you may want to exclude.
Removing Exchange Wallets
Known Solana exchange wallets to filter out:
| Exchange | Wallet Prefix | Action |
|---|---|---|
| Binance | Multiple | Remove from airdrop |
| Coinbase | Multiple | Remove from airdrop |
| Kraken | Multiple | Remove from airdrop |
Tip: Search "Solana exchange wallets list" for updated addresses, or check if balances are suspiciously large and static.
Removing Dust Wallets
Wallets with tiny balances (dust) often aren't real users:
Filter: Balance > 10 tokens (or your preferred minimum)
Removing Program Accounts
Some "holders" are actually smart contracts or program accounts:
- Liquidity pools
- Staking contracts
- Token vesting contracts
Check if the address is a known program before including in airdrops.
Token Snapshot for Different Token Standards
SPL Tokens (Original Standard)
The standard Solana token program. Most tokens use this:
- USDC, USDT, BONK, WIF, JUP
- Straightforward snapshot process
- Works with all snapshot tools
SPL22 / Token Extensions (Token-2022)
Newer token standard with advanced features:
- Transfer fees
- Interest-bearing tokens
- Non-transferable tokens
- Confidential transfers
Important: Make sure your snapshot tool supports Token-2022. Jumpbit Token Snapshot handles both standards automatically.
Troubleshooting Common Issues
"Invalid Token Address"
Cause: You entered something that isn't a valid Solana mint address.
Fix:
- Verify the address on Solscan
- Ensure you're using the mint address, not a token account
- Check for extra spaces or characters
"No Holders Found"
Cause: The token has zero holders or the mint is incorrect.
Fix:
- Confirm the token exists and has been distributed
- Verify mint address on a blockchain explorer
- Check if the token is on the correct network (mainnet vs devnet)
"Snapshot Taking Too Long"
Cause: Token has millions of holders.
Fix:
- Wait for processing (can take 60-90 seconds for 1M+ holders)
- Check your internet connection
- Try during off-peak hours if RPC nodes are congested
"Balance Shows Zero"
Cause: Holder recently transferred out or data is from a previous block.
Fix:
- Refresh and take a new snapshot
- Verify current balance on explorer
- Note that snapshots are point-in-time—balances change constantly
Alternative Methods for Token Snapshots
Method 1: Helius API
// Requires API key and coding
const response = await fetch(
`https://api.helius.xyz/v0/token-accounts?api-key=${API_KEY}`,
{
method: 'POST',
body: JSON.stringify({ mint: 'TOKEN_MINT' })
}
);
Pros: Programmable, customizable
Cons: Requires coding, API key, rate limits apply
Method 2: Direct RPC Query
// Using getProgramAccounts
const accounts = await connection.getProgramAccounts(
TOKEN_PROGRAM_ID,
{
filters: [
{ dataSize: 165 },
{ memcmp: { offset: 0, bytes: mintAddress } }
]
}
);
Pros: No third-party dependency
Cons: Complex, slow for large tokens, requires RPC expertise
Method 3: Snapshot Tool (Recommended)
No code, no API keys, just paste and export.
Pros: Fast, simple, export-ready formats
Cons: Less customizable than API methods
Best Practices for Token Snapshots
1. Document Your Snapshot Time
Always record when the snapshot was taken. This is crucial for:
- Governance vote eligibility disputes
- Airdrop fairness verification
- Historical analysis
2. Take Multiple Snapshots
Don't rely on a single snapshot. Take snapshots at:
- Announcement time (baseline)
- Distribution time (final eligibility)
- Post-distribution (verification)
3. Verify Random Samples
Spot-check 5-10 random addresses on Solscan to verify balances match your snapshot data.
4. Secure Your Data
Holder lists are valuable data. Store securely and don't share publicly unless intended.
5. Consider Privacy
Some holders may not want their addresses publicly linked to token holdings. Be mindful when publishing holder lists.
Key Takeaways
Taking a token snapshot on Solana is straightforward:
- Get your token's mint address
- Use a snapshot tool (no coding required)
- Generate and download your holder list
- Filter and process for your specific use case
The entire process takes under 60 seconds for most tokens.
Ready to snapshot your token?
Try Jumpbit Token Snapshot—paste your mint address and export in seconds.
Top comments (0)