开发者平台
主题

获取区块详情#

查询指定高度区块的区块头明细信息,包括出块者、Gas、难度、确认数等完整字段。

支持的链:见获取区块 API 支持的链apiNameblock-fills)。

请求地址#

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

请求参数#

参数名类型是否必填描述
chainIndexString链唯一标识,如 ETH 为 1、BTC 为 0;支持范围见获取区块 API 支持的链
heightString区块高度(纯数字)

响应参数#

参数名类型描述
chainIndexString链唯一标识
hashString区块哈希
heightString区块高度
validatorString出块者/超级节点/验证人
blockTimeString出块时间;Unix 时间戳的毫秒数格式,如 1597026383085
txnCountString该区块包含的交易条数
amountString该区块交易金额
blockSizeString区块大小,单位:bytes
mineRewardString区块奖励,块收益等于 mineReward+totalFee
totalFeeString该区块所有手续费总和
feeSymbolString手续费币种
ommerBlockString叔块数量
merkleRootHashString默克尔根哈希
gasUsedStringGas 消耗
gasLimitStringGas 限额
gasAvgPriceStringGas 均价
stateString块状态,确认中:pending、确认完成:done;不适用的链返回空串 ""
burntString销毁手续费数量
txnInternalString该区块包含的内部交易条数
minerString矿工地址哈希
difficultyString挖矿难度
nonceString在 PoW 区块链中,nonce 用于描述挖矿难度
tipsString小费
confirmString确认数
baseFeePerGasString每 Gas 基础费

请求示例#

shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/block/block-fills?chainIndex=1&height=19000000' \
--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",
            "hash": "0xba9ded5ca1ec9adb9451bf062c9de309d9552fa0f0254a7b982d3daf7ae436cd",
            "height": "19000000",
            "validator": "beaverbuild",
            "blockTime": "1705146239000",
            "txnCount": "150",
            "amount": "213.6975",
            "blockSize": "57619",
            "mineReward": "0.044304750347454041",
            "totalFee": "0.352967975656501696",
            "feeSymbol": "ETH",
            "ommerBlock": "0",
            "merkleRootHash": "0x2f8b104344fca4fbca3b6ba1b46247ae2ac02c15dcd7a19b4549351c110c6c5a",
            "gasUsed": "12849554",
            "gasLimit": "30000000",
            "gasAvgPrice": "0.000000027468899821",
            "state": "",
            "burnt": "0.308663225309047655",
            "txnInternal": "46",
            "miner": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
            "difficulty": "0",
            "nonce": "0000000000000000",
            "tips": "0.000866267",
            "confirm": "1024",
            "baseFeePerGas": "0.000000024021260851"
        }
    ]
}