{"uid":"cap_cwPov_b4_Vvw3pOGJKb4k","slug":"vextorium-contract-events-cc52b62a","name":"Vextorium Contract Events","description":"Latest events emitted by an EVM contract from the event signature (e.g. Transfer(address indexed from,address indexed to,uint256 value)), decoded with parameter names, block and transaction hash, over the last N blocks.","url":"https://api.vextorium.com/v1/contract-events?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"event":{"type":"string","description":"Event signature with indexed markers and names"},"limit":{"type":"integer","description":"Events (1-200, default 50)"},"blocks":{"type":"integer","description":"Blocks back (10-5000, default 2000)"},"network":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"contract":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":"Dynamic values (non-indexed string/bytes) are returned as a raw word.","event":"Transfer(address,address,uint256)","found":1957,"events":[{"hash":"0x359530c6c0662f964433082b08488f565b893a9c54083a6edb12b3e04a8333d5","block":52083754,"values":{"to":"0x41D4934322f2bd6fE1dbe4124070FE61651A2067","from":"0x61040E143A77F165Ba44543AF4A079F2C809D14b","value":"83126144588"}},{"hash":"0x48d57ad6140d5c2a949f7ce0dcdfff54cc13f75010a762428c9080f0ac26e5fe","block":52083754,"values":{"to":"0xb2cc224c1c9feE385f8ad6a55b4d94E92359DC59","from":"0x787fD1dc3b533171781e4Ae1A563c1AC7b4435E4","value":"149022949510"}}],"topic0":"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","network":"base","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","reviewed_blocks":20}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pEiKXHYH4b5Gm9olAT7Cn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and decodes the latest events emitted by an EVM smart contract given a full event signature, returning parameter values, block numbers, and transaction hashes over a specified block range.","exampleAgentPrompt":"Can you pull the last 100 Transfer(address indexed from, address indexed to, uint256 value) events from contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, looking back over the last 2000 blocks, and show me the decoded addresses and amounts?","exampleUseCases":[{"title":"Track ERC-20 token transfers in real time","prompt":"Get me the latest 50 Transfer(address indexed from, address indexed to, uint256 value) events from contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base over the last 1000 blocks, decoded with sender, receiver, and amount."},{"title":"Monitor DeFi swap events on Arbitrum","prompt":"Fetch the last 200 Swap(address indexed sender, address indexed recipient, int256 amount0, int256 amount1, uint160 sqrtPriceX96, uint128 liquidity, int24 tick) events from contract 0xC31E54c7a869B9FcBEcc14363CF510d1c41fa443 on Arbitrum over 5000 blocks, so I can see recent swap activity."},{"title":"Audit NFT mint events on Ethereum","prompt":"Pull the latest 100 Transfer(address indexed from, address indexed to, uint256 indexed tokenId) events from NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum for the last 3000 blocks — I want to see which addresses are minting tokens and the transaction hashes."}],"resultDescription":"Returns a JSON object containing the canonical event signature, the keccak256 topic0 hash, the network and contract queried, total events found, number of blocks reviewed, and an array of decoded event objects — each with the transaction hash, block number, and a values map of named parameters (e.g. 'from', 'to', 'value') extracted from the event log data.","failureModes":["Invalid or malformed event signature returns an error or empty results","Contract address not found on the specified network returns zero events","Block range exceeds the 5000-block maximum, causing a validation error","Network enum value not supported returns a schema validation error","Non-indexed dynamic parameters (string/bytes) are returned as raw 32-byte words rather than decoded strings","Requesting more than 200 events returns a validation error","Payment not attached or insufficient USDC causes an x402 payment required error"],"whenToPreferThis":"Choose this endpoint when you need decoded, human-readable event logs from a specific EVM smart contract across Base, Ethereum, Arbitrum, Optimism, or Polygon — especially when you have the full event signature with parameter names and need values decoded by name rather than raw hex. It's ideal for monitoring recent on-chain activity, auditing contract events, or extracting structured data from event logs without running your own node. Prefer it over generic block explorers when you need programmatic, structured JSON output ready for agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:54:41.740Z","isFirstParty":false,"canonicalSlug":"vextorium-contract-events-cc52b62a"}