# eth_getLogs：區塊範圍限制、參數與 CU

> Source: https://docs.blockvectra.com/zh-hant/api/json-rpc/methods/eth_getLogs/

## 用途

按過濾條件查詢區塊範圍內的日誌（事件）。

## 計算單位（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。

## 請求範例

```bash
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
  }'
```

## 可用鏈

全部 9 條支援鏈均可用。

大跨度查詢請參閱 [eth\_getLogs 區塊範圍限制與分段查詢指南](https://docs.blockvectra.com/zh-hant/guides/getlogs-block-range/)。錯誤詳情與建議處理動作見 [logs\_range\_too\_large 錯誤參考](https://docs.blockvectra.com/zh-hant/errors/#logs_range_too_large)。