> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update to Token Holders API

*Published February 20, 2025*

![Update to Token Holders API](https://www.datocms-assets.com/86369/1741047446-token-holders-api-update-feb2025.jpg)

The following changes were made to the [Token Holders API](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2):

* 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](https://goldrush.dev/chains/) as listed on [CoinGecko](https://www.coingecko.com/en/categories/ethereum-ecosystem).

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](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2)