Used to get a paginated list of current or historical token holders for a specified ERC20 or ERC721 token.
block-height
is specified, the default is to use the latest token holder snapshot which updates every 30 mins.To fetch the current token holders list without using the snapshot, set no-snapshot=true
.Page size is either 100
(default) or 1000
.Supported only on Foundational Chains.Related guides
Bearer authentication header of the form: Bearer <token>
, where <token>
is your GoldRush API Key.
The chain name eg: eth-mainnet
.
The requested address. Passing in an ENS
, RNS
, Lens Handle
, or an Unstoppable Domain
resolves automatically.
Defaults to false
. Set to true
to bypass last snapshot and get the latest token holders list.
Ending block to define a block range. Omitting this parameter defaults to the latest block height.
Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
Number of items per page. Note: Currently, only values of 100
and 1000
are supported. Omitting this parameter defaults to 100.
0-indexed page number to begin pagination.
Successful response
The response is of type object
.