开发者平台
主题

获取区块基础统计信息#

查询指定公链的区块基础统计信息,包括最新区块高度、首个区块信息、平均出块时间与平均区块大小等。

支持的链:见获取公链信息 API 支持的链apiNameblock)。

请求地址#

GET
https://web3.okx.com/api/v6/explorer/info/block

请求参数#

参数名类型是否必填描述
chainIndexString链唯一标识,如 ETH 为 1、BTC 为 0;支持范围见获取公链信息 API 支持的链

响应参数#

参数名类型描述
chainIndexString链唯一标识
symbolString公链原生代币
lastHeightString最新区块高度
firstExchangeHistoricalTimeString第一次交易时间;Unix 时间戳的毫秒数格式,如 1597026383085
firstBlockTimeString第一次出块时间;Unix 时间戳的毫秒数格式,如 1597026383085
firstBlockHeightString第一个区块高度
avgBlockIntervalString平均出块时间(近一周)
avgBlockSize24hString平均区块大小(24 小时)
avgBlockSize24hPercentString平均区块大小涨跌幅
mediaBlockSizeString区块大小中位数(近一周)
halveTimeString减半时间;Unix 时间戳的毫秒数格式,如 1597026383085

请求示例#

shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/info/block?chainIndex=1' \
--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": [
        {
            "chainIndex": "1",
            "symbol": "ETH",
            "lastHeight": "22990123",
            "firstExchangeHistoricalTime": "",
            "firstBlockTime": "1438269973000",
            "firstBlockHeight": "0",
            "avgBlockInterval": "12.08",
            "avgBlockSize24h": "78345",
            "avgBlockSize24hPercent": "0.0123",
            "mediaBlockSize": "72110",
            "halveTime": ""
        }
    ]
}