JSON-RPC方法
eth_getLogs:区块范围限制、参数与 CU
用 eth_getLogs 按区块范围与地址、topics 过滤条件查询合约事件日志,结果按区块顺序返回数组,无匹配时返回空数组。区块跨度超过该链限制时返回 -32602,此时应缩小范围分段查询。
用途
按过滤条件查询区块范围内的日志(事件)。
计算单位(CU)与价格
单次调用 CU
30 CU
每百万次调用价格(USD)
$3.00
参数
| 参数名 | 类型 | 说明 |
|---|---|---|
filter | object | 过滤对象:fromBlock、toBlock(区块高度或标签,默认 latest)、address(单个地址或地址数组)、topics(主题数组,每项可为 null、单个 32 字节主题或主题数组),也可用 blockHash 指定单个区块。 |
返回值
- 类型:
ARRAY - 说明: 日志对象数组,按区块顺序排列;无匹配时返回空数组。
注意事项
blockHash 与 fromBlock/toBlock 互斥;topics 按位置逐层匹配,null 表示该位置不限。区块跨度超过该链的 max_logs_block_range(见 GET /v1/chains)时返回 -32602。
请求示例
export BLOCKVECTRA_API_KEY=rgw_your_api_key
curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
-H 'Content-Type: application/json' \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"address": "0x0000000000000000000000000000000000000000",
"fromBlock": "latest",
"toBlock": "latest"
}
],
"id": 1
}'可用链
全部 29 条支持链均可用。
相关参考
大跨度查询请参阅 eth_getLogs 区块范围限制与分段查询指南。错误详情与建议处理动作见 logs_range_too_large 错误参考。
最后更新: