获取区块统计数据#
查询公链按天维度的区块历史统计数据，包括每日出块数量、平均区块大小、区块奖励与平均出块时间；数据按日期由近到远返回。仅部分主流公链支持（BTC、ETH、TRON 及主流 EVM 链等）。
支持的链：见获取区块 API 支持的链（apiName：block-stats）。
请求地址#
GET
https://web3.okx.com/api/v6/explorer/block/block-stats请求参数#
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| chainIndex | String | 是 | 链唯一标识，如 ETH 为 1、BTC 为 0；支持范围见获取区块 API 支持的链 |
| startTime | String | 否 | 查询开始时间；Unix 时间戳的毫秒数格式，如 1597026383085；startTime 与 endTime 之差最长不超过 1 年 |
| endTime | String | 否 | 查询结束时间；Unix 时间戳的毫秒数格式，如 1597026383085；startTime 与 endTime 之差最长不超过 1 年 |
| cursor | String | 否 | 分页游标；取上次响应返回的 cursor，首次请求不传 |
| limit | String | 否 | 返回条数，默认返回最近的 20 条，最多 100 条 |
响应参数#
| 参数名 | 类型 | 描述 |
|---|---|---|
| limit | String | 本页条数上限 |
| cursor | String | 下一页游标；空串表示没有更多。请求时原样回传，客户端不应解析或构造 |
| blockHistoryList | Array | 区块历史统计数据 |
| > time | String | 日期，以天为维度；Unix 时间戳的毫秒数格式，如 1597026383085 |
| > blockCount | String | 每日总出块数量 |
| > blockSize | String | 每日平均区块大小，单位：bytes |
| > mineReward | String | 每日总区块奖励 |
| > rewardSymbol | String | 每日总区块奖励的单位 |
| > avgBlockInterval | String | 每日平均出块时间，单位：s |
请求示例#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/block/block-stats?chainIndex=1&limit=20' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
响应示例#
json
{
"code": "0",
"msg": "",
"data": [
{
"limit": "20",
"cursor": "MTcwNTA1OTgzOTAwMA",
"blockHistoryList": [
{
"time": "1705104000000",
"blockCount": "7126",
"blockSize": "98510",
"mineReward": "327.5041",
"rewardSymbol": "ETH",
"avgBlockInterval": "12.12"
},
{
"time": "1705017600000",
"blockCount": "7130",
"blockSize": "97236",
"mineReward": "331.2087",
"rewardSymbol": "ETH",
"avgBlockInterval": "12.11"
}
]
}
]
}