{"uid":"cap_4gJlF4dlV5iEGFiJ6yx5p","slug":"skills-onesource-io-ca624841","name":"OneSource Chain Events — eth_getLogs Query","description":"Query Ethereum contract event logs via eth_getLogs - filter by contract, topic, and block range","url":"https://skills.onesource.io/api/chain/events","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"topic":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"network":{"enum":["ethereum","sepolia","avax","megaeth","megaeth-testnet","base"],"type":"string","default":"ethereum"},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"to_block":{"oneOf":[{"type":"integer","minimum":0},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}]},"from_block":{"oneOf":[{"type":"integer","minimum":0},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}]}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.005000/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_QOLCuAvtgKJ-MZnZ_EV-R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queries Ethereum-compatible contract event logs using eth_getLogs, filtered by contract address, event topic, and block range across multiple networks","exampleAgentPrompt":"Pull all Transfer event logs (topic 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef) for the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum from block 19000000 to latest.","exampleUseCases":[{"title":"Track NFT minting activity across collections","prompt":"Show me all Mint events from the Blur Blur collection contract 0x4b1d6fb6416b37fbe7e6a1af1ad0f91e4d1fb1a5 on Ethereum over the last 100 blocks so I can identify recent NFT creators."},{"title":"Monitor DEX swap volume by protocol","prompt":"Get all Swap events from the Uniswap V3 SwapRouter contract 0xE592427A0AEce92De3Edee1F18E0157C05861564 on Base network between blocks 12000000 and 12500000 to analyze trading activity."},{"title":"Audit staking contract participant changes","prompt":"Pull all Deposit and Withdrawal event logs from our staking contract 0x1234567890abcdef1234567890abcdef12345678 on Avalanche from the past 1000 blocks to reconcile our staker ledger."}],"resultDescription":"Returns an array of event log objects matching the filter criteria, each containing the contract address, transaction hash, block number, log index, topics array, and raw data field — corresponding to the eth_getLogs RPC response format.","failureModes":["Invalid contract address format (not a valid 0x + 40 hex chars) returns 400 validation error","Invalid topic format (not a valid 0x + 64 hex chars) returns 400 validation error","Block range too large may result in timeout or truncated results","Unsupported network value returns enum validation error","No logs found for the given filter returns empty array","RPC node unavailability returns 503 or gateway error","Payment not provided or insufficient USDC balance returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to query historical or recent smart contract event logs on EVM-compatible chains (Ethereum, Base, Avalanche, Sepolia, MegaETH) by topic hash and/or contract address. Prefer this over full transaction lookups when you only need emitted events, not full transaction details. Ideal for tracking ERC20 transfers, DEX swaps, NFT mints, or any indexed contract activity within a specific block range.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:11.726Z","isFirstParty":false}