📘
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/{API-KEY}/tokenholder/ \
-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": "59d30c83562b9f9d1989ceb8ceaf4f6f7e749e8ffd1440d577fc0823169b0866"
}