根据区块区间和地址获取事件日志#

查询指定合约地址在给定区块高度区间内产生的事件日志，按游标（cursor）翻页返回。本接口仅支持 EVM 系公链。

支持的链：见获取事件日志 API 支持的链（apiName：by-block-and-address）。

请求地址#

GET

https://web3.okx.com/api/v6/explorer/log/by-block-and-address

请求参数#

参数名	类型	是否必填	描述
chainIndex	String	是	链唯一标识，如 ETH 为 1、BTC 为 0；支持范围见获取事件日志 API 支持的链
startBlockHeight	String	是	起始区块高度，最小为 1
endBlockHeight	String	是	结束区块高度，最小为 1
address	String	是	合约地址
cursor	String	否	上次响应返回的游标；不传或传空串从第一页开始
limit	String	否	每页条数，默认 100，最大 1000

响应参数#

参数名	类型	描述
limit	String	本页条数上限
cursor	String	下一页游标；空串表示没有更多。请求时原样回传，客户端不应解析或构造
logList	Array	事件日志列表
> height	String	区块高度
> address	String	产生该事件日志的合约地址
> topics	Array	topic 列表，元素为 String
> data	String	事件日志的 data 数据，十六进制字符串
> methodId	String	methodId，触发该日志的方法标识
> blockHash	String	区块哈希
> transactionTime	String	交易时间，Unix 时间戳的毫秒数格式
> logIndex	String	日志 index
> txId	String	交易哈希

请求示例#shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/log/by-block-and-address?chainIndex=1&startBlockHeight=19000000&endBlockHeight=19000100&address=0xdac17f958d2ee523a2206206994597c13d831ec7' \
--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": "100",
            "cursor": "100",
            "logList": [
                {
                    "height": "19000012",
                    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x0000000000000000000000005041ed759dd4afc3a72b8192c143f72f4724081a",
                        "0x000000000000000000000000c6a2ad8cc6e4a7e08fc37cc5954be07d499e7654"
                    ],
                    "data": "0x00000000000000000000000000000000000000000000000000000000004c4b40",
                    "methodId": "0xa9059cbb",
                    "blockHash": "0x1f3c5a0d9e7b2c4a6d8f0b1c3e5a7d9f2b4c6e8a0d1f3b5c7e9a2d4f6b8c0e1a",
                    "transactionTime": "1705316735000",
                    "logIndex": "156",
                    "txId": "0x7d4b1e9c3a5f70d2b8e6c4a1f9d3b5e7c0a2d4f6b8e1c3a5d7f9b2e4c6a8d0f3"
                }
            ]
        }
    ]
}
上一頁获取事件日志 API 支持的链下一頁根据地址和 Topic 获取事件日志