List Achievements
Achievements
List Achievements
Get all available achievements in the ZKScore ecosystem
GET
List Achievements
Overview
Retrieve a complete list of all available achievements in the ZKScore platform. This endpoint supports filtering by category, rarity, and status, making it easy to discover achievements and build achievement galleries.Parameters
Filter by achievement category
wallet_age- Wallet longevity achievementstransaction_volume- Volume-based achievementsprotocol_usage- Protocol interaction achievementsgovernance- DAO participation achievementssocial- Social reputation achievementsdefi- DeFi-specific achievementsnft- NFT-related achievementstrading- Trading achievements
Filter by rarity level
common- Easy to earnuncommon- Moderate difficultyrare- Challengingepic- Very challenginglegendary- Extremely rare
Filter by achievement status
active- Currently availableupcoming- Coming soonlimited- Limited time onlyretired- No longer available
Number of results to return (default: 50, max: 100)
Number of results to skip for pagination (default: 0)
Response
Indicates if the request was successful
Array of achievement objects
Examples
Response Example
Achievement Categories
Wallet Age
- Early Adopter - Wallet created before 2020
- Veteran - Wallet active for 3+ years
- OG - Wallet from 2017 or earlier
Transaction Volume
- Volume Trader - $100K+ total volume
- Whale - $1M+ total volume
- Mega Whale - $10M+ total volume
Protocol Usage
- Protocol Explorer - Used 10+ protocols
- Multi-Chain Master - Active on 5+ chains
- DeFi Pioneer - Used 50+ DeFi protocols
Governance
- Active Voter - Voted on 10+ proposals
- DAO Participant - Active in 5+ DAOs
- Governance Guru - Voted on 100+ proposals
Social
- Well Connected - 50+ trusted connections
- Community Leader - 100+ attestations received
- Influencer - 500+ social connections
DeFi
- Yield Farmer - Provided liquidity to 10+ pools
- Lending Pro - Lent assets on 5+ platforms
- DeFi Native - Active DeFi user for 2+ years
NFT
- NFT Collector - Own 50+ NFTs
- Blue Chip Holder - Own NFTs from top collections
- NFT Trader - Traded 100+ NFTs
Trading
- Day Trader - 1000+ trades
- Profitable Trader - 80%+ win rate
- Market Maker - Provided liquidity consistently
Use Cases
1. Achievement Gallery
Display all available achievements:2. Filter by Rarity
Show achievements by rarity:3. Discover New Achievements
Show recently added achievements:4. Paginated Achievement List
Implement pagination:Best Practices
1. Cache Achievement List
Achievements don’t change frequently:2. Group by Category
Organize achievements for better UX:3. Sort by Difficulty
Show achievements by difficulty:4. Calculate Completion Rate
Show how rare each achievement is:Related Endpoints
- Get User Achievements - User’s earned achievements
- Get Achievement Progress - Progress toward achievement
- Claim Achievement - Claim an earned achievement
Troubleshooting
”No achievements found”
Cause: Filters are too restrictive or no achievements match criteria. Solution:- Remove some filters
- Check filter values are correct
- Try without filters to see all achievements
”Invalid category”
Cause: Unsupported category value. Solution:- Use supported categories:
wallet_age,transaction_volume,protocol_usage,governance,social,defi,nft,trading - Check for typos
Rate Limits
Achievement list requests are subject to rate limits:- Free tier: 60 requests per minute
- Starter tier: 300 requests per minute
- Professional tier: 1,000 requests per minute
- Enterprise tier: Custom limits