JSON-RPC方法

eth_getLogs:区块范围限制、参数与 CU

用 eth_getLogs 按区块范围与地址、topics 过滤条件查询合约事件日志,结果按区块顺序返回数组,无匹配时返回空数组。区块跨度超过该链限制时返回 -32602,此时应缩小范围分段查询。

用途

按过滤条件查询区块范围内的日志(事件)。

计算单位(CU)与价格

单次调用 CU

30 CU

每百万次调用价格(USD)

$3.00

参数

参数名类型说明
filterobject过滤对象: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 错误参考。

最后更新: