{"uid":"cap_6eCu6veht85bAUJIn8YKR","slug":"base-chain-on-chain-event-log-decoder-6918d2c8","name":"Base Chain On-Chain Event Log Decoder","description":"On-demand, decoded on-chain events for AI agents: query a contract's event logs on Base (eth_getLogs) and get normalized, human-readable events — Transfer, Approval, ERC-1155 TransferSingle/Batch, Uniswap V2/V3 Swap, Sync, Mint, Burn — with raw topics for unknown signatures. Filter by event name, full signature or topic0, and by block range or lookback. Decoded event feed with no RPC setup, block span capped.","url":"https://x402-endpoints.onrender.com/chain/events","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["contract"],"properties":{"event":{"type":"string","description":"Event name (Transfer/Approval/Swap/Mint/Burn/TransferSingle/Sync), full signature 'Transfer(address,address,uint256)', or 0x topic0. Omit for all."},"limit":{"type":"integer","description":"Max events (1-100, most recent in range)"},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Contract address to read logs from (0x + 40 hex)"},"lookback":{"type":"integer","description":"If from/to omitted, scan the last N blocks (1-5000, default 2000)"},"to_block":{"type":"integer","description":"End block (inclusive). Omit for latest."},"from_block":{"type":"integer","description":"Start block (inclusive). Omit to use lookback."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"rpc":{"provider":"alchemy","fallback_used":false},"count":1,"query":{"event":"Transfer","limit":10,"topic0":"0xddf252ad...b3ef","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","lookback":500,"to_block":33810500,"from_block":33810000},"cached":false,"events":[{"event":"Transfer","params":{"to":"0x2222...","from":"0x1111...","value":1500000},"topic0":"0xddf252ad...b3ef","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decoded":true,"tx_hash":"0xabc...","log_index":12,"signature":"Transfer(address,address,uint256)","block_number":33810480}],"source":"Base JSON-RPC eth_getLogs (Alchemy, fallback public RPC)","decoders":["Approval","Burn","Mint","Swap(V2)","Swap(V3)","Sync","Transfer","TransferBatch","TransferSingle"],"timestamp":"2026-07-02T12:00:00Z","truncated":false,"disclaimer":"Decoded from public on-chain logs; unknown event signatures are returned raw. Block span and result count are capped.","block_range":{"span":500,"to_block":33810500,"from_block":33810000,"latest_block":33810500},"total_in_range":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__uqC5gcJfEkAuM6xZ78z7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Query and decode on-chain event logs for any contract on Base, returning normalized human-readable events (Transfer, Approval, Swap, Mint, Burn, ERC-1155, Uniswap V2/V3) without requiring RPC setup.","exampleAgentPrompt":"Can you pull the last 50 decoded Transfer events for contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base, looking back 3000 blocks?","exampleUseCases":null,"resultDescription":"A list of decoded, human-readable on-chain events from the specified contract on Base, including event name, parsed arguments, block number, transaction hash, and log index. Known event types (Transfer, Approval, Swap, Mint, Burn, Sync, TransferSingle, TransferBatch) are fully decoded; unknown signatures return raw topic arrays.","failureModes":["Invalid contract address format (must be 0x + 40 hex chars) — returns 400","Block range exceeds cap — returns error with allowed span limit","No events found in the specified range — returns empty list","Lookback value out of range (must be 1–5000) — returns 400","Limit out of range (must be 1–100) — returns 400","Network or RPC backend error — returns 5xx"],"whenToPreferThis":"Use this endpoint when you need decoded, human-readable on-chain events from a Base contract without managing your own RPC node or writing eth_getLogs queries. Ideal for AI agents that need to understand token transfers, DeFi swap activity, NFT mints/burns, or ERC-1155 batch transfers for a specific contract, especially when you want normalized output rather than raw hex logs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:15.623Z","isFirstParty":false}