Appearance
Holder Snapshot Export
PRO Feature
Holder Snapshot Export is available to PRO subscribers. View plan tiers.
Export a point-in-time snapshot of your token's holder list. Use it for airdrops, governance snapshots, community analysis, or any workflow that needs a verified list of token holders.
What's Included
Each export captures:
| Field | Description |
|---|---|
wallet_address | Holder's wallet address |
balance | Token balance at time of snapshot |
percentage | Percentage of total supply held |
chain | Chain the tokens are held on |
first_seen | Date the wallet first acquired tokens |
CSV Format
Exports are delivered as CSV files with the following structure:
csv
wallet_address,balance,percentage,chain,first_seen
0x1a2b3c...def,1000000,2.50,arbitrum,2025-03-15
0x4d5e6f...abc,500000,1.25,arbitrum,2025-04-02
7Hk9mN...xyz,250000,0.63,solana,2025-05-10- File naming:
{SYMBOL}_{CHAIN}_holders_{YYYY-MM-DD}.csv - Encoding: UTF-8
- Delimiter: Comma-separated
- Header row included
- Sorted by balance descending
How to Export
- Navigate to your token's Manager Profile
- Click Export Holders in the tools section
- Select the chain (or all chains for multi-chain registrations)
- Click Generate Snapshot
- Download the CSV file when ready
Processing Time
Large holder lists (10,000+ addresses) may take up to 60 seconds to generate.
Limits
| Constraint | Value |
|---|---|
| Exports per day | Varies by plan — see Token Plans |
| Minimum holders for export | 1 |
| Maximum rows per file | 100,000 |
| Data freshness | Real-time at time of request |
Common Use Cases
Airdrop Distribution
Export your holder list and use it as an airdrop allowlist. The balance and percentage fields let you calculate proportional distributions — then run the distribution itself with Airdrops, which pulls from your wallet non-custodially as holders claim.
Governance Snapshots
Capture holder balances at a specific point in time for on-chain or off-chain governance votes.
Community Analysis
Track holder growth over time by comparing exports from different dates. Identify your largest holders and newest community members.
Cross-Chain Aggregation
For tokens registered on multiple chains, export all chains at once to get a unified view of your holder base across networks.
Multi-Chain Exports
If your token is registered across multiple chains, you can:
- Export a single chain for chain-specific operations
- Export all chains for a unified holder list
Multi-chain exports include the chain column to distinguish which network each holder is on. Duplicate wallets across chains appear as separate rows.
Data Privacy
- Only public on-chain data is exported (wallet addresses and balances)
- No personal information is included
- Exports are available only to the verified owner or designated manager