{"uid":"cap_atLlGPWbkHh76aakBSSXX","slug":"code402-chain-data-ethereum-block-number-125eef93","name":"code402 Chain Data – Ethereum Block Number","description":"Deterministic compliance verification (IBAN, sanctions, onchain address) with XDR-1 signed receipts, plus Ethereum chain-data endpoints. Paid per call via x402 on Base (USDC).","url":"https://verify.code402.dev/v1/chain/block-number?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object"}}},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"result":"string","network":"ethereum-mainnet"}}}}},"responseSchema":{"type":"json","example":{"result":"chain data","network":"ethereum"}},"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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7LMVLMVAqPzDw_blDOgeu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current (latest) Ethereum mainnet block height as a real-time lookup","exampleAgentPrompt":"What's the current Ethereum mainnet block number right now?","exampleUseCases":[{"title":"Smart contract deployment timing","prompt":"Before I deploy my contract, can you grab the current Ethereum block number so I can set the right starting block for event listeners?"},{"title":"Blockchain sync health check","prompt":"Is my Ethereum node in sync? Pull the latest block number from mainnet and compare it to what my node reports."},{"title":"Onchain timestamp anchoring","prompt":"I need to anchor a document hash to the Ethereum blockchain — what's the current block height so I can record it alongside the hash?"}],"resultDescription":"A JSON object containing the current Ethereum mainnet block number as a string (e.g. '19500000') and the network identifier 'ethereum-mainnet', representing the latest confirmed block at the time of the request.","failureModes":["Network or upstream node unavailability returns a 5xx error","Payment not included or invalid x402 payment header returns a 402 Payment Required error","Rate limiting may return a 429 if requests are too frequent","Response may lag by 1-2 blocks behind true chain tip due to node propagation"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, pay-per-call real-time Ethereum block height lookup without setting up your own node or RPC provider subscription. It is ideal for agents that only occasionally need block number data and want to avoid managing API keys or node infrastructure. Prefer alternatives (e.g., direct Infura/Alchemy RPC calls) if you need very high-frequency polling or additional chain data beyond block number.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:40:43.824Z","isFirstParty":false,"canonicalSlug":"code402-chain-data-ethereum-block-number-125eef93"}