# eth_getLogs：参数、返回值与 CU

> 原文地址: https://docs.blockvectra.com/zh/api/json-rpc/methods/eth_getLogs/

## 用途

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

## 计算单位（CU）与价格

CU 权重、价格与各链可用状态见方法页： https://docs.blockvectra.com/zh/api/json-rpc/methods/eth_getLogs/

## 参数

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| `filter` | `object` | 过滤对象：fromBlock、toBlock（区块高度或标签，默认 latest）、address（单个地址或地址数组）、topics（主题数组，每项可为 null、单个 32 字节主题或主题数组），也可用 blockHash 指定单个区块。 |

## 返回值

- **类型**: `ARRAY`
- **说明**: 日志对象数组，按区块顺序排列；无匹配时返回空数组。

## 注意事项

blockHash 与 fromBlock/toBlock 互斥；topics 按位置逐层匹配，null 表示该位置不限。

## 请求示例

```bash
curl -X POST "https://dev-api.blockvectra.network/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: <api_key>' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "address": "<address>",
        "fromBlock": "<fromBlock>",
        "toBlock": "latest"
      }
    ],
    "id": 1
  }'
```