Retrieve Token Holders

📘

Supported on Monad Testnet.

🚧

The Token Holders API on Monad is currently available to our paid Members. Free tier members can also enjoy a trial period with 30 free calls. If you're interested, please register directly through here. Please note that the API Key can also be used for your RPC endpoint.

Parameter

• contractAddress, string - a 42 character address with '0x' as prefix. The token contract address to check for holders.
• pageIndex, string - the page number to retrieve. Defaults to 1.
• pageSize, string - the number of holders to return per page. Defaults to 20, maximum is 50.

Response

• code, number - response status code, e.g., 0 for success.
• reason, string - reason message if there's an error.
• message, string - response message, e.g., OK.
• result, object - result object containing token holder data.
  • data, array object - an array of token holder objects.
    • holder, string - the wallet address of the token holder.
    • percentage, string - the percentage of the total supply held by this holder.
    • usdValue, string - the USD value of the holder's tokens (if available).
    • amount, string - the amount of tokens owned by the holder.
    • isContract, boolean - whether the holder address is a contract.
  • nextPageIndex, number - the index of the next page of results.