This API helps you to send the async task to NodeReal, you will get a resource ID to retrieve the historical token holder list. Supports both fungible tokens(ERC-20, BEP-20) and NFT(ERC-721, BEP-721, ERC-1155, BEP-1155).


Supported on BSC mainnet only.

Available token type:

  • Fungible token (ERC-20, BEP-20)
  • NFT (ERC-721, BEP-721, ERC-1155, BEP-1155)


This API submits an async task to the server, after you get the success response of this API, please call nr_gethistorytokenholder to get the token holder list by submitting the same contractAddress, blockNumber, and the resource ID you got from this API.


Rate limit

This API consumes huge server resources. To ensure the API availability of entire the NodeReal community, it could only proceed with no more than 5 requests per minute.


  • contractAddress - The contract address of the token
  • blockNumber - The block number in hex format.


  • result - the resource id

API Endpoint

The endpoint of this API is{API-KEY}/tokenholder/
Here is an example:

You could refer to this guidance Find API key & endpoint for the API key.



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


    "jsonrpc": "2.0",
    "id": 1,
    "result": "a4a4b76170ddc1w2d060717342826c31ca4307w8d3edfbb01593f5c48c78b7ab"