Skip to main content
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.
Use this endpoint to display available achievements, show requirements, and help users discover what they can earn.

Parameters

string
Filter by achievement category
  • wallet_age - Wallet longevity achievements
  • transaction_volume - Volume-based achievements
  • protocol_usage - Protocol interaction achievements
  • governance - DAO participation achievements
  • social - Social reputation achievements
  • defi - DeFi-specific achievements
  • nft - NFT-related achievements
  • trading - Trading achievements
string
Filter by rarity level
  • common - Easy to earn
  • uncommon - Moderate difficulty
  • rare - Challenging
  • epic - Very challenging
  • legendary - Extremely rare
string
Filter by achievement status
  • active - Currently available
  • upcoming - Coming soon
  • limited - Limited time only
  • retired - No longer available
number
Number of results to return (default: 50, max: 100)
number
Number of results to skip for pagination (default: 0)

Response

boolean
Indicates if the request was successful
array
Array of achievement objects
object

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

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:

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
Implement caching to reduce API calls.