Show / Hide Table of Contents

getnep11balances 方法

返回指定地址内的所有 NEP-11 资产余额。

此方法由插件提供,需要安装 TokensTrackerLevelDBStoreRpcServer 插件才可以调用。

参数说明

address:要查看资产余额的地址。

配置说明

调用该方法之前,需要在插件 TokensTracker 的 config.json 文件中设置以下字段:

  • MaxResults:最大记录数,超过数额将不会被存储。

  • Network:需要与Neo-cli 的 config.json 中的Network设置相同。

调用示例

请求正文:

{
  "jsonrpc": "2.0",
  "method": "getnep11balances",
  "params": ["NdUL5oDPD159KeFpD5A9zw5xNF1xLX6nLT"],
  "id": 1
}

响应正文:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "address": "NdUL5oDPD159KeFpD5A9zw5xNF1xLX6nLT",
        "balance": [
            {
                "assethash": "0xb3b65e5c0d2af3f98cac6e80083f6c2b90476f40",
                "tokens": [
                    {
                        "tokenid": "426c696e6420426f782032",
                        "amount": "1",
                        "lastupdatedblock": 36653
                    },
                    {
                        "tokenid": "426c696e6420426f782033",
                        "amount": "1",
                        "lastupdatedblock": 37100
                    },
                    {
                        "tokenid": "426c696e6420426f782031323635",
                        "amount": "1",
                        "lastupdatedblock": 501483
                    }
                ]
            }
        ]
    }
}
  • 当未同步到发布合约的区块时,执行该 API 会报错,只有当区块同步到发布该合约资产的区块时,才会返回正确的结果。

  • 当输入的参数为非 NEP-17 标准的智能合约的 Script Hash 时,执行该 API 会报错。

  • 当区块未完全同步时,返回的资产余额可能不是最新的,请确保使用该 API 时区块已经同步到最新高度。