This API helps you to get the historical token holder list by giving the contract address, block number, and resource ID. 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 is an async task that requires the result from nr_historytokenholdersend API. Before calling this API, please submit a request to nr_historytokenholdersend to get the resource ID.



  • result
    • status - 0: Error; 1: Success; 2: Generating; 3: Incorrect resource ID
    • links - the link of the token holder list, in JSON file format

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_getHistoryTokenHolder","params":["0xeDa21B525Ac789EaB1a08ef2404dd8505FfB973D","0x1550e20", "a4a4b76170ddc1w2d060717342826c31ca4307w8d3edfbb01593f5c48c78b7ab"],"id": 1 }'


    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "status": 1,
        "links": [


Please note that the file from the result will only be available for 24 hours. You would need to submit a new task if the file is expired.

You will see the historical token holder list data in the file, including:

  • blockNumber
  • tokenAddress
  • holders (array)
    • account
    • balance
    • tokenType (if NFT)
    • tokenId (if NFT)