---
updatedAt: 2025-03-17T22:03:39.000Z
agentTools:
  projectIndex: https://docs.infstones.com/llms.txt
---

# eth_getFilterChanges

Polling method for a filter, which returns an array of logs which occurred since last poll.

> 🚧
>
> **NOTE**: Filter must be created by calling either `eth_newFilter` or `eth_newBlockFilter`.

# Parameters

| Object Name | Required | Type   | Detail                                                  |
| :---------- | :------- | :----- | :------------------------------------------------------ |
| `FILTER ID` | ✅        | String | A hex code of an integer that represents the filter id. |

```
"params": [
    "unknown"
]
```

# Result

An array of log objects, or an empty array if nothing has changed since last poll.

> 🚧
>
> **NOTE**: `eth_getFilterChanges` only returns logs since the filter was created, regardless of the block passed in to create the filter. To get logs ranging from a specific block you should use [eth\_getLogs](https://dash.readme.com/project/infstones/v1.0/refs/template-copy-12).

* For filters created with `eth_newBlockFilter` the return are block hashes (`DATA`, 32 Bytes), e.g. `["0x123456789..."]`.
* For filters created with `eth_newFilter` logs are objects with following params:

**Result Fields**

| Key                | Type    | Detail                                                                                                                                                 |
| :----------------- | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `address`          | String  | Address from which this log originated.                                                                                                                |
| `blockHash`        | String  | Hash of the block where this log was in. `null` if either the returned block is pending or the log is pending.                                         |
| `blockNumber`      | String  | A hex code of an integer that represents the block number where this log was in. `null` if either the returned block is pending or the log is pending. |
| `data`             | String  | Contains one or more 32 Bytes non-indexed arguments of the log.                                                                                        |
| `logIndex`         | String  | A hex code of an integer that represents the log index position in the block. `null` if the log is pending.                                            |
| `removed`          | Boolean | `true` if the log was removed, due to a chain reorganization. `false` if the log is valid.                                                             |
| `topics`           | Array   | Array of 0 to 4. 32 Bytes `DATA` of indexed log arguments.                                                                                             |
| `transactionHash`  | String  | Hash of the transactions this log was created from. `null` if the log is pending.                                                                      |
| `transactionIndex` | String  | A hex code of an integer that represents the transactions index position log was created from. `null` if the log is pending.                           |

# Example

**Request**

```curl
curl <your-endpoint> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["unknown"],"id":73}'
```

**Return**

```
unknown
```

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "bnb-chain",
    "version": "1.1"
  },
  "servers": [
    {
      "url": "https://api.infstones.com/bsc/mainnet"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/{project_id}": {
      "post": {
        "summary": "web3_sha3",
        "description": "Returns Keccak-256 (not the standardized SHA3-256) of the given data.",
        "operationId": "bnb-chain-web3-sha3",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "schema": {
              "type": "string",
              "default": "c94411509d724306b407dbfa6521dac2"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "RAW_BODY": {
                    "type": "string",
                    "default": "{\"jsonrpc\":\"2.0\",\"method\":\"web3_sha3\",\"params\":[\"0x67656c6c6f20776f726c64\"],\"id\":1}"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```