查询区块交易列表#

获取 TradeZone 单个区块内的交易列表。

请求路径#

GET
https://web3.okx.com/api/v5/xlayer/tz/block/transaction-list

请求参数#

参数名类型是否必须描述
chainShortNameString公链缩写符号,例如 TRADE_ZONE
heightString需要查询的区块高度
limitInteger每次请求返回的结果数量,最大值为 100,默认值为 20
pageInteger页码,默认值为 1

响应参数#

参数名类型描述
pageString当前页码
limitString每页返回的结果数
totalPageString总页数
totalString总记录数
dataArray交易列表
> hashString交易哈希
> blockHeightString区块高度
> blockHashString区块哈希
> blockTimeString区块时间(毫秒)
> statusString交易状态:0x1 成功 / 0x0 失败
> fromString业务执行用户地址
> actionTypeStringAction 类型
> indexString执行顺序
> valueString交易金额(按代币精度处理)
> valueRawString交易金额(最小单位整数)

请求示例#

shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/tz/block/transaction-list?chainShortName=TRADE_ZONE&height=21217618&limit=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": [
        {
            "page": "1",
            "limit": "1",
            "totalPage": "4",
            "total": "4",
            "data": [
                {
                    "hash": "0x8248c0466e31765fa0731c6aae1d35e3b525567c6afe1013800d9895470021c3",
                    "blockHeight": "21217618",
                    "blockHash": "0xdf8ad76a3fac0a8af9d8496bc68319a53dafe1e9c4965e0b34d0364c561f2cbd",
                    "blockTime": "1779156763517",
                    "status": "0x1",
                    "from": "0x7ad674c0595de0885f7335b8dcaa91ca5d1723e5",
                    "actionType": "updateOwner",
                    "index": "3",
                    "value": "",
                    "valueRaw": ""
                }
            ]
        }
    ]
}