This API method helps you to get the current token holders and the number of tokens held.


Supported on BSC and ETH mainnet only.


  • Contract Address - the address of the contract
  • PageSize - pageSize is hex encoded and should be less equal than 100 (each page return at most pageSize items)
  • PageKey - It should be empty for the first page. If more results are available, a pageKey will be returned in the response. Pass the pageKey to fetch the next pageSize items.
  • topN - (optional) hex encoded string; if use the topN parameter, it will return at most N records and results will be returned by balance order.


  • accountAddress - the address of the account
  • tokenBalance - the balance of the token

API Endpoint

The format of a MegaNode API endpoint is https://{chain}-{network}{API-key}
Here is an example:

For other chains or networks, you could refer to this guidance Find API key & endpoint.



curl  \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"nr_getTokenHolders","params":["0xcea59dce6a6d73a24e6d6944cfabc330814c098a", "0x14",""],"id": 1 }'


  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "pageKey": "100_342",
    "details": [
        "accountAddress": "0x00000000100f9d75535cbf23f82e23db5558e8c1",
        "tokenBalance": "0x0000000000000000000000000000000000000000f"