跳转至

/wallet/gettransactioncountbyblocknum

返回某区块高度包含的交易数。

  • 源码:framework/src/main/java/org/tron/core/services/http/GetTransactionCountByBlockNumServlet.java
  • Method:GET / POST
  • Request:api.NumberMessage
  • 支持固化接口:/walletsolidity/gettransactioncountbyblocknum

请求参数

GET 从 URL 查询参数读取以下字段;POST 从 JSON 请求体读取。

字段 方法 类型 必填 说明
num GET int64 区块高度;缺失时执行 Long.parseLong(null) 并失败
num POST int64 区块高度;Protobuf 默认值为 0
int64_as_string GET bool 仅 GET;为 true 时将 count 作为 JSON 字符串返回

示例:

curl --request POST \
     --url https://nile.trongrid.io/wallet/gettransactioncountbyblocknum \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{ "num": 66987565 }
'

响应

字段 类型 说明
count int64 该区块的交易数;区块不存在返回 0

响应示例:

{ "count": 4 }

使用 GET 请求并添加 ?int64_as_string=true 时:

{ "count": "4" }

异常响应

方法 触发条件 响应
GET / POST 请求体超过 node.http.maxMessageSize 通常由 SizeLimitHandler 返回 HTTP 413 Payload Too Large
GET num 不是数字(GET) {"Error": "class java.lang.NumberFormatException : <message>"}
POST 请求体不是合法 JSON / 字段类型不符(POST) {"Error": "class org.tron.json.JSONException : <解析器信息>"}{"Error": "class org.tron.core.services.http.JsonFormat$ParseException : <解码器信息>"}
GET / POST 其他异常 {"Error": "<exceptionClass> : <message>"}