evm-event-logs
GET api.agentstools.dev/evm/logs
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
Read a contract's recent event logs on an EVM network over a bounded block window and decode them. Logs are decoded from an event signature you supply, or from the contract's verified ABI, or by resolving the topic to a name via 4byte. Raw logs are always returned; decoded fields are added where possible.
Resource: api.agentstools.dev/evm/logs
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493
Payment methods: — · Last validation: 2026-09-14 12:24:27.027+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"address"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max decoded logs to return (default 200)"
},
"blocks": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Look-back window in blocks (default 2000)"
},
"topic0": {
"type": "string",
"description": "Event topic0 hash to filter by (alternative to signature), 0x + 64 hex"
},
"address": {
"type": "string",
"description": "Contract address, 0x + 40 hex"
},
"network": {
"enum": [
"base",
"ethereum",
"arbitrum",
"optimism",
"polygon",
"bnb"
],
"type": "string",
"description": "EVM network (default base)"
},
"signature": {
"type": "string",
"description": "Event signature to filter and decode by, e.g. Transfer(address,address,uint256)"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "10000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.