API Reference

nr_getNFTInventory

This API method helps you to get the BEP-721/1155 token inventory of an address, filtered by contract address.

📘

Supported on BSC and ETH mainnet only.

Parameters

  • Account Address - The address of the account in hex format
  • 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.

Returns

  • pageKey - string, example: 100_342
  • details
    • tokenAddress - string, the address of the token
    • tokenId - string, the id of the token
    • balance - string, the balance of the token

API Endpoint

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

https://bsc-mainnet.nodereal.io/v1/4c0a1c23661a4e26bcbcwed461e34ea9

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

Example

Request

curl https://bsc-mainnet.nodereal.io/v1/your-api-key \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"nr_getNFTInventory","params":["0x0042f9b78c67eb30c020a56d07f9a2fc83bc2514","0x64aF96778bA83b7d4509123146E2B3b07F7deF52","0x14",""],"id": 1 }'

Result

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "pageKey": "100_342",
    "details": [
      {
        "tokenAddress": "0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
        "tokenId": "0x0000000000000000000000000000000000000000f",
        "balance": "0x00000000000000000000000000000000000000001"
      }
    ]
  }
}