{"uid":"cap_7YmNEEIQYmuazwcf7hlGc","slug":"block402-ethereum-json-rpc-api-8c86c784","name":"Block402 Ethereum JSON-RPC API","description":"Blockchain intelligence for AI agents. Query blockchain data through a read-only, pay-per-request API with x402.","url":"https://api.block402.xyz/rpc/ethereum?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":["string","integer"]},"method":{"enum":["eth_chainId","eth_blockNumber","eth_syncing","net_version","net_listening","net_peerCount","web3_clientVersion","eth_gasPrice","eth_maxPriorityFeePerGas","eth_blobBaseFee","web3_sha3","eth_getBlockTransactionCountByNumber","eth_getUncleCountByBlockNumber","eth_getBlockByNumber","eth_getTransactionByBlockNumberAndIndex","eth_getUncleByBlockNumberAndIndex","eth_getRawTransactionByBlockNumberAndIndex","eth_getBlockTransactionCountByHash","eth_getUncleCountByBlockHash","eth_getBlockByHash","eth_getTransactionByBlockHashAndIndex","eth_getUncleByBlockHashAndIndex","eth_getRawTransactionByBlockHashAndIndex","eth_getBalance","eth_getTransactionCount","eth_getCode","eth_getStorageAt","eth_getTransactionByHash","eth_getTransactionReceipt","eth_getRawTransactionByHash","eth_feeHistory","eth_call","eth_estimateGas","eth_createAccessList","eth_getProof","eth_getLogs","eth_getBlockReceipts"],"type":"string"},"params":{"type":"array","maxItems":20},"jsonrpc":{"const":"2.0"}}},"responseSchema":{"type":"json","example":{"id":1,"result":"0x1","jsonrpc":"2.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uzY6KYnOUaN9ECxyE7pkl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Query Ethereum blockchain data via standard JSON-RPC methods through a pay-per-request API designed for AI agents","exampleAgentPrompt":"What's the current ETH balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, and what's the current gas price on Ethereum right now?","exampleUseCases":[{"title":"DeFi portfolio balance checker","prompt":"Check the ETH balance of wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum and tell me how many transactions it has sent."},{"title":"Smart contract audit data pull","prompt":"Fetch the bytecode of the smart contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I can review what's deployed there."},{"title":"Transaction confirmation lookup","prompt":"Look up the transaction receipt for Ethereum tx hash 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060 and tell me if it succeeded and how much gas it used."}],"resultDescription":"A JSON-RPC 2.0 response object containing the result of the requested Ethereum RPC call — which may include block data (hash, number, transactions, timestamp), account balances in wei, transaction details or receipts, contract bytecode, storage values, event logs, gas price estimates, or fee history depending on the method called.","failureModes":["Invalid or unsupported JSON-RPC method returns an error response","Malformed params array causes a parse or invalid params error","Querying a block or transaction hash that doesn't exist returns null result","Payment failure or insufficient USDC balance prevents request from being processed","Rate limiting or network congestion may cause timeouts","Write methods (eth_sendRawTransaction, eth_sign, etc.) are not supported as this is read-only"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to query live Ethereum blockchain state — balances, transactions, blocks, logs, contract code — on a pay-per-request basis without committing to a subscription. Ideal for agents that need occasional or unpredictable Ethereum RPC access and want to pay per call in USDC via x402. Prefer over free public RPC nodes when reliability and metered billing matter, and over subscription RPC providers when usage is sporadic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:35:07.296Z","isFirstParty":false,"canonicalSlug":"block402-ethereum-json-rpc-api-8c86c784"}