Skip to main content
Update to Token Holders API The following changes were made to the Token Holders API:
  • When no block-height is specified, the response is from the latest token holder snapshot that is updated every 30 minutes. This results in a fast response time.
  • To fetch the current token holders list without using the snapshot, set no-snapshot=true. This bypasses the cache and is dynamically calculated at request time.
The snapshot exists for the top 100 tokens on each Foundational Chain as listed on CoinGecko. This modification is to help address the two unique use cases for this API:
  1. Displaying a list of token holders on leaderboards to provide guidance on a token’s distribution. This list does not generally need to be accurate to the minute.
  2. Token holder lists for reward distributions and token gating. This is generally an accurate token list generated at a specific point in time.
Learn more