Search the event logs of an EVM contract
evm_logsEvent logs of a contract over recent blocks (default 1,000, max 5,000), newest first, max 100: block, transaction hash, topics and data. topic0 takes an event signature such as Transfer(address,address,uint256) or a 32-byte hash. Public nodes refuse very large results: narrow the range or add topic0. Related tools on this server, for a different need: evm_balance when you need ERC-20 balance of an address for one token contract; evm_call when you need to read the result of a read-only EVM contract function. Price: $0.003 per successful call, paid with x402 (USDC on Base, Solana and 10 more networks); failed calls are not charged.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"contract": "<contract>"
},
"name": "evm_logs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | base (default), ethereum, arbitrum, optimism or polygon | |
| blocks | No | Blocks to search back from the latest (max 5000) | |
| topic0 | No | Event signature, e.g. Transfer(address,address,uint256), or a 32-byte hash | |
| contract | Yes | Contract address, 0x… |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| logs | No | ||
| chain | No | ||
| count | No | ||
| source | No | ||
| topic0 | No | ||
| window | No | ||
| contract | No | ||
| checkedAt | No | ||
| truncated | No | ||
| disclaimer | No |