获取区块列表#

查询指定公链的区块列表，按区块高度由新到旧返回；可通过 height 参数定位指定高度的区块。

支持的链：见获取区块 API 支持的链（apiName：block-list）。

请求地址#

GET

https://web3.okx.com/api/v6/explorer/block/block-list

请求参数#

参数名	类型	是否必填	描述
chainIndex	String	是	链唯一标识，如 ETH 为 1、BTC 为 0；支持范围见获取区块 API 支持的链
height	String	否	区块高度（纯数字）；指定时查询该高度的区块，不传时返回最新区块列表
cursor	String	否	分页游标；取上次响应返回的 cursor，首次请求不传
limit	String	否	返回条数，默认返回最近的 20 条，最多 100 条

响应参数#

参数名	类型	描述
limit	String	本页条数上限
cursor	String	下一页游标；空串表示没有更多。请求时原样回传，客户端不应解析或构造
chainIndex	String	链唯一标识
blockList	Array	区块列表
> hash	String	区块哈希
> height	String	区块高度
> validator	String	出块者/超级节点/验证人
> blockTime	String	出块时间；Unix 时间戳的毫秒数格式，如 1597026383085
> txnCount	String	该区块包含的交易条数
> blockSize	String	区块大小，单位：bytes
> mineReward	String	区块奖励，块收益等于 mineReward+totalFee
> totalFee	String	该区块所有手续费总和
> feeSymbol	String	手续费币种
> avgFee	String	每笔交易平均手续费
> ommerBlock	String	叔块数量
> gasUsed	String	Gas 消耗
> gasLimit	String	Gas 限额
> gasAvgPrice	String	Gas 均价
> state	String	块状态，确认中：pending、确认完成：done；不适用的链返回空串 ""
> burnt	String	销毁手续费数量

请求示例#shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/block/block-list?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": "2",
            "chainIndex": "1",
            "blockList": [
                {
                    "hash": "0xba9ded5ca1ec9adb9451bf062c9de309d9552fa0f0254a7b982d3daf7ae436cd",
                    "height": "19000000",
                    "validator": "beaverbuild",
                    "blockTime": "1705146239000",
                    "txnCount": "150",
                    "blockSize": "57619",
                    "mineReward": "0.044304750347454041",
                    "totalFee": "0.352967975656501696",
                    "feeSymbol": "ETH",
                    "avgFee": "0.0023",
                    "ommerBlock": "0",
                    "gasUsed": "12849554",
                    "gasLimit": "30000000",
                    "gasAvgPrice": "0.000000027468899821",
                    "state": "",
                    "burnt": "0.308663225309047655"
                }
            ]
        }
    ]
}
上一页获取区块 API 支持的链下一页获取区块详情