GET /v1/:chainName/tokens/:tokenAddress/token_holders_v2 — goldrush-multichain-data-apis

latestOpenAPI 3.1.02026-08-0837114837.8 KB

c099830c76a0

check-ownership-in-nft-collection1

check-ownership-in-nft-collection-token1

get-a-block1

get-a-transaction1

get-address-activity1

get-all-chain-statuses1

get-all-chains1

get-all-transactions-in-a-block2

get-all-transactions-in-a-block-by-page1

get-allchains-balances1

get-allchains-transactions1

get-bitcoin-balance-for-address1

get-bitcoin-balances-for-hd-address1

get-block-heights1

get-earliest-transactions-for-address-v31

get-erc20-token-transfers-for-address1

get-gas-prices1

get-historical-bitcoin-balance-for-address1

get-historical-portfolio-value-over-time1

get-historical-token-balances-for-address1

get-historical-token-prices1

get-log-events-by-contract-address1

get-log-events-by-topic-hash1

get-logs1

get-native-token-balance1

get-nfts-for-address1

get-paginated-transactions-for-address-v31

get-pool-spot-prices1

get-recent-transactions-for-address-v31

get-resolved-address-for-registered-address1

get-time-bucket-transactions-for-address-v31

get-token-approvals-for-address1

get-token-balances-for-address1

get-token-holders-as-of-any-block-height-v21

get/v1/{chainName}/tokens/{tokenAddress}/token_holders_v2/

get-transaction-summary-for-address1

get-transactions-for-bitcoin-address1

get-token-holders-as-of-any-block-height-v2

Used to get a paginated list of current or historical token holders for a specified ERC20 or ERC721 token.

get/v1/{chainName}/tokens/{tokenAddress}/token_holders_v2/

Path parameters

chainNamestring required

The chain name eg: eth-mainnet.

tokenAddressstring required

The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

Query parameters

no-snapshotboolean

Defaults to false. Set to true to bypass last snapshot and get the latest token holders list.

block-heightinteger

Ending block to define a block range. Omitting this parameter defaults to the latest block height.

datestring

Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.

page-sizeinteger

Number of items per page. Note: Currently, only values of 100 and 1000 are supported. Omitting this parameter defaults to 100.

page-numberinteger

0-indexed page number to begin pagination.

Response

Successful response

updated_atstring date-time

The timestamp when the response was generated. Useful to show data staleness to users.

chain_idinteger

The requested chain ID eg: 1.

chain_namestring

The requested chain name eg: eth-mainnet.

chain_tip_heightinteger

The latest block height of the blockchain at the time this response was provided.

chain_tip_signed_atstring date-time

The timestamp of the latest signed block at the time this response was provided.