{"slug":"agentshelf-syntexa-ch-v1-eth-events-c0cd4d","title":"Call when an agent needs raw Ethereum logs for one contract, with optional topic","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/eth-events","category":"code","description":"Call when an agent needs raw Ethereum logs for one contract, with optional topic0-topic3, a block range of at most 2000, and an optional event signature for decoding. HTTP 429 is not billed. Read-only. No spend. Send JSON fields address (string), topic0 (string), event (string). Exact $0.005 USDC on","price_listed":0.005,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","event":"Transfer(address indexed from, address indexed to, uint256 value)","topic0":"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"examples":[{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","event":"Transfer(address indexed from, address indexed to, uint256 value)","topic0":"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"}],"properties":{"address":{"description":"Contract on Ethereum mainnet. Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 (Circle USDC). Logs are filtered to this address. EIP-55 or all one case.","examples":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],"type":"string"},"event":{"description":"Optional Solidity event signature. Example: Transfer(address indexed from, address indexed to, uint256 value). topic0 defaults to its keccak. Arrays are not decoded.","examples":["Transfer(address indexed from, address indexed to, uint256 value)"],"maxLength":300,"pattern":"^[A-Za-z_][A-Za-z0-9_]*\\([A-Za-z0-9_,\\s]*\\)$","type":"string"},"from_block":{"description":"First block, inclusive. The inclusive span is at most 2000 blocks. Omit both bounds for the latest 25 blocks. Omit both bounds for the default recent window.","pattern":"^(0|[1-9]\\d*)$","type":"string"},"to_block":{"description":"Last block, inclusive, or latest. The inclusive span is at most 2000 blocks. Omit both bounds for the latest 25 blocks. Omit it to anchor the default window.","type":"string"},"topic0":{"description":"First log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position.","examples":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],"pattern":"^0x[0-9a-fA-F]{64}$","type":"string"},"topic1":{"description":"Second log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position.","pattern":"^0x[0-9a-fA-F]{64}$","type":"string"},"topic2":{"description":"Third log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position.","pattern":"^0x[0-9a-fA-F]{64}$","type":"string"},"topic3":{"description":"Fourth log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position.","pattern":"^0x[0-9a-fA-F]{64}$","type":"string"}},"required":["address"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"examples":[{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","billed":true,"from_block":26246376,"logs":[{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","block_number":26246401,"data":"0x00000000000000000000000000000000000000000000000000000000000f4240","decoded":{"args":[{"indexed":true,"name":"from","type":"address","value":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},{"indexed":true,"name":"to","type":"address","value":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"indexed":false,"name":"value","type":"uint256","value":"1000000"}],"event":"Transfer"},"log_index":12,"topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045","0x000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"transaction_hash":"0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"}],"network":"eip155:1","ok":true,"receipt_id":"rcpt_01EXAMPLE000000000000000","to_block":26246401,"truncated":false,"warnings":[]}],"properties":{"address":{"examples":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],"type":"string"},"billed":{"examples":[true],"type":"boolean"},"from_block":{"examples":[26246376],"minimum":0,"type":"integer"},"logs":{"examples":[[{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","block_number":26246401,"data":"0x00000000000000000000000000000000000000000000000000000000000f4240","decoded":{"args":[{"indexed":true,"name":"from","type":"address","value":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},{"indexed":true,"name":"to","type":"address","value":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"indexed":false,"name":"value","type":"uint256","value":"1000000"}],"event":"Transfer"},"log_index":12,"topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045","0x000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"transaction_hash":"0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"}]],"items":{"additionalProperties":false,"properties":{"address":{"type":"string"},"block_number":{"minimum":0,"type":"integer"},"data":{"type":"string"},"decoded":{"anyOf":[{"additionalProperties":false,"properties":{"args":{"items":{"additionalProperties":false,"properties":{"indexed":{"type":"boolean"},"name":{"type":"string"},"type":{"enum":["address","uint256","int256","bool","bytes32","bytes4","string","bytes"],"type":"string"},"value":{"type":"string"}},"required":["name","type","indexed","value"],"type":"object"},"maxItems":16,"type":"array"},"event":{"type":"string"}},"required":["event","args"],"type":"object"},{"type":"null"}]},"log_index":{"minimum":0,"type":"integer"},"topics":{"items":{"type":"string"},"maxItems":4,"type":"array"},"transaction_hash":{"type":"string"}},"required":["address","topics","data","block_number","transaction_hash","log_index","decoded"],"type":"object"},"maxItems":50,"type":"array"},"network":{"const":"eip155:1","examples":["eip155:1"],"type":"string"},"ok":{"const":true,"examples":[true],"type":"boolean"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"to_block":{"examples":[26246401],"minimum":0,"type":"integer"},"truncated":{"examples":[false],"type":"boolean"},"warnings":{"default":[],"examples":[[]],"items":{"type":"string"},"type":"array"}},"required":["ok","receipt_id","billed","network","address","from_block","to_block","truncated","logs"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Call when an agent needs raw Ethereum logs for one contract, with optional topic0-topic3, a block range of at most 2000, and an optional event signature for decoding. HTTP 429 is not billed. Read-only. No spend. Send JSON fields address (string), topic0 (string), event (string). Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/eth-events first.","last_updated":"2026-10-22T07:20:47.925Z","schemes":["exact"]}