{"uid":"cap_6poMEpiUXHsp9X1pPOGsp","slug":"agent402-block-receipts-93a1818a","name":"Agent402 Block Receipts","description":"Every transaction receipt in one block, fetched as a single upstream read and summarised: tx count, succeeded vs failed, total gas used, total fees, log count, contract creations, tx-type mix - plus compact per-transaction rows (hash, from, to, status, gas used, effective gas price, fee, log count) capped at 300. Block analytics, failed-tx hunting, or 'who paid what in block N' without N separate receipt calls.","url":"https://agent402.tools/api/block-receipts","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"block":{"type":"string","description":"Block number (decimal or 0x hex) or latest."},"limit":{"type":"number","description":"Per-transaction rows to return, 0-300 (default 100). The summary always covers the whole block."},"network":{"type":"string","description":"ethereum / base / polygon / arbitrum / optimism (default ethereum)."}}},"responseSchema":{"type":"json","example":{"block":25563191,"source":"alchemy","chainId":1,"network":"ethereum","summary":{"types":{"0x0":16,"0x2":126,"0x3":1,"0x4":6},"failed":6,"feeWei":"4453605500724532","gasUsed":"16506190","txCount":149,"logCount":420,"feeNative":"0.004453605500724532","succeeded":143,"contractCreations":0},"receipts":[{"to":"0x7c46…0f54","from":"0xb01c…9c2e","hash":"0xdcae…9cd6","type":"0x2","index":0,"feeWei":"21852814746000","status":"success","gasUsed":"21000","logCount":0,"contractAddress":null,"effectiveGasPriceGwei":1.040610226}],"returned":5,"blockHash":"0x8e12…1243","fetchedAt":"2026-08-22T12:00:00.000Z"}},"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_hW8x3BEGTHWe_jFC9uWDh","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 transaction receipts and a summary for a specific Ethereum-compatible block, including gas usage, fee totals, transaction types, and per-transaction details.","exampleAgentPrompt":"Can you pull all the transaction receipts for block 25563191 on Ethereum and give me a summary of gas used, fees, and how many transactions succeeded or failed?","exampleUseCases":[{"title":"Audit gas fees for a block","prompt":"Fetch the full receipt summary for block 20000000 on Base — I want to know the total gas used, total fees in ETH, and a breakdown of transaction types."},{"title":"Investigate failed transactions in a block","prompt":"Can you check block 19500000 on Ethereum and tell me how many transactions failed, what their hashes were, and how much gas they consumed? Show me up to 50 receipts."},{"title":"Monitor Polygon block activity","prompt":"Get the receipts for the latest block on Polygon and summarize how many transactions there were, how many created contracts, and what the total fees were."}],"resultDescription":"Returns a JSON object containing: the block number, source (Alchemy), chainId, network name, a summary object (transaction type counts, failed/succeeded counts, total fee in Wei and native units, gas used, tx count, log count, contract creations), an array of per-transaction receipts (to, from, hash, type, index, feeWei, status, gasUsed, logCount, contractAddress, effectiveGasPriceGwei), total returned count, blockHash, and fetch timestamp.","failureModes":["Invalid or non-existent block number returns an error or empty result","Unsupported network name causes a validation error","Limit value outside 0–300 range may be rejected or clamped","Block not yet finalized (future block) returns not-found error","Network congestion or upstream Alchemy timeout causes slow or failed response"],"whenToPreferThis":"Choose this endpoint when you need comprehensive receipt-level data for an entire block across major EVM-compatible networks (Ethereum, Base, Polygon, Arbitrum, Optimism), including aggregated summaries and per-transaction status, fees, and gas. It is especially useful for on-chain analytics, block auditing, or fee monitoring where you want both a block-level summary and individual receipt details in a single call without setting up your own RPC infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:52:48.614Z","isFirstParty":false}