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:

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

1. Navigate to your token's Manager Profile
2. Click Export Holders in the tools section
3. Select the chain (or all chains for multi-chain registrations)
4. Click Generate Snapshot
5. 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