获取区块列表或单个区块详情
1. 概述与典型用途
分页查询区块列表，或通过指定区块号获取单个区块的详细信息。支持按超级代表地址和时间范围过滤。
- 典型用途：区块浏览器列表页、按区块号查询区块详情、按超级代表查询出块记录。
- 何时不要用：查询区块统计汇总数据用「获取区块统计信息」；查询交易列表用「获取交易列表」。
2. 接口与鉴权
GET /api/block
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start | integer | 否 | 0 | 起始编号（偏移量）；start + limit ≤ 10000 |
limit | integer | 否 | 10 | 每页数量，最大 50 |
number | integer | 否 | — | 区块号。提供时返回该单个区块的详情，且忽略时间范围参数 |
producer | string | 否 | — | 超级代表地址，按出块者过滤 |
sort | string | 否 | -number | 排序字段，仅支持按区块号排序，- 前缀表示降序 |
start_timestamp | integer | 否 | 0 | 开始时间戳，毫秒 |
end_timestamp | integer | 否 | 当前时间 | 结束时间戳，毫秒 |
count | boolean | 否 | false | 是否统计并返回总数，影响 rangeTotal 字段 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 命中总数（上限 10000） | — |
rangeTotal | integer | 必返 | 过滤范围内区块总数 | — |
data | array | 必返 | 区块列表 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
number | integer | 必返 | 区块号 | — |
hash | string | 必返 | 区块哈希 | — |
size | integer | 必返 | 区块大小 | 字节 |
timestamp | integer | 必返 | 区块时间 | 毫秒时间戳 ms |
txTrieRoot | string | 必返 | 交易 Trie 根哈希 | — |
parentHash | string | 必返 | 父区块哈希 | — |
witnessId | integer | 必返 | 出块超级代表 ID | — |
witnessAddress | string | 必返 | 出块超级代表地址 | — |
witnessName | string | 必返 | 出块超级代表名称 | — |
version | integer | 必返 | 区块版本号 | — |
nrOfTrx | integer | 必返 | 区块内交易数 | — |
fee | number | 必返 | 区块总手续费 | TRX |
confirmed | boolean | 必返 | 是否已确认 | — |
confirmations | integer | 必返 | 确认数 | — |
netUsage | integer | 必返 | 带宽消耗总量 | — |
energyUsage | integer | 必返 | 能量消耗总量 | — |
OtherFeeTrx | number | 必返 | 其他手续费 | TRX |
otherFeeMap | object | 可选 | 其他费用明细 map（可为空对象）；单块查询（number=X）时返回，列表查询不返回 | — |
bandwidthConsumedFromBurnCnt | integer | 必返 | 从燃烧消耗的带宽笔数 | — |
freeBandwidthUsageCnt | integer | 必返 | 使用免费带宽的笔数 | — |
bandwidthBurnFeeSunAmt | integer | 必返 | 带宽燃烧费用 | sun |
energyConsumedFromOwnerBurnCnt | integer | 必返 | 合约方承担能量燃烧笔数 | — |
freeEnergyUsageCnt | integer | 必返 | 使用免费能量的笔数 | — |
energyBurnFeeSunAmt | integer | 必返 | 能量燃烧费用 | sun |
blockReward | number | 必返 | 出块奖励 | TRX |
voteReward | number | 必返 | 投票奖励 | TRX |
revert | boolean | 必返 | 是否已回退 | — |
trxAnd10TransferCount | integer | 可选 | TRX 和 TRC10 转账数量（单块查询时返回） | — |
trc20And721TransferCount | integer | 可选 | TRC20 和 TRC721 转账数量（单块查询时返回） | — |
trc1155TransferCount | integer | 可选 | TRC1155 转账数量（单块查询时返回） | — |
transferCount | integer | 可选 | 总转账数量（单块查询时返回） | — |
failTxCount | integer | 可选 | 失败交易数量（单块查询时返回） | — |
internalTxCount | integer | 可选 | 内部交易数量（单块查询时返回） | — |
internalParentTxCount | integer | 可选 | 含内部交易的父交易数量（单块查询时返回） | — |
contractTypeDistribute | object | 可选 | 各合约类型及其交易数量的分布（单块查询时返回） | — |
srConfirmList | array | 可选 | SR 确认列表（单块查询时返回） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
start + limit超过 10000：超出后被静默截断并返回200，不会报错。number不存在：返回200+data: []，不会报 4xx。- 空结果 ≠ 错误：无命中返回
200+data: []，属于正常响应。
最后更新于: