API Reference

nr_historyTokenHolderSend

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.

Parameters

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

Returns

  • result - the resource id

API Endpoint

The endpoint of this API is https://open-platform.nodereal.io/{API-KEY}/tokenholder/
Here is an example:

https://open-platform.nodereal.io/64a9df0874fb4a93b9d0a3849de012d3/tokenholder/

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

Example

Request

curl https://open-platform.nodereal.io/v1/your-api-key \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"nr_historyTokenHolderSend","params":["0xeDa21B525Ac789EaB1a08ef2404dd8505FfB973D","0x1550e20"],"id": 1 }'

Result

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