{"uid":"cap_ayYExveZOi_elol8AsyfR","slug":"block-time-eta-1b66b6c5","name":"Block Time ETA","description":"Estimate seconds to target block from current height and block time. Call when scheduling waits or SLA checks for confirmation targets. Returns eta_seconds and blocks remaining as deterministic JSON for $0.001 USDC via x402 on Base. First-party local math only—no RPC, live market feed, API keys, storage, or mediagen. Advisory only; the caller owns capital, risk, and production controls.","url":"https://api.delx.ai/api/v1/x402/block-time-eta","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"blocks":{"type":"integer","description":"Input field: blocks."},"seconds_per_block":{"type":"integer","description":"Input field: seconds per block."}}},"responseSchema":{"type":"json","example":{"blocks":10,"schema":"delx/util-block-time-eta/v1","eta_seconds":20,"seconds_per_block":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ElPIXm4PrOW7oNwZ4fPkY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Estimates seconds until a target block height is reached given current block height offset and average block time, returning ETA and remaining block count.","exampleAgentPrompt":"I need to wait for 50 more blocks to be confirmed — with an average block time of 12 seconds per block, how many seconds will that take and how many blocks are left?","exampleUseCases":[{"title":"Ethereum transaction confirmation wait","prompt":"We're waiting for a transaction to reach 20 confirmations and average block time is 12 seconds — how long should my workflow sleep before checking again?"},{"title":"L2 finality SLA check","prompt":"Our SLA requires finality within 300 seconds. If we have 25 blocks left and each block takes 2 seconds, will we make it?"},{"title":"Scheduling a timed on-chain action","prompt":"I want to trigger a contract call after 100 more blocks on a chain with 3 seconds per block — give me the ETA in seconds so I can set a timer."}],"resultDescription":"Returns a deterministic JSON object containing eta_seconds (estimated seconds until target block) and blocks_remaining, computed purely from local arithmetic with no RPC or live data calls.","failureModes":["Missing or non-integer 'blocks' field returns validation error","Missing or non-integer 'seconds_per_block' field returns validation error","Zero or negative seconds_per_block may produce undefined or error result","Payment not included or insufficient USDC via x402 returns 402 Payment Required","Result is advisory only — actual block times vary; caller assumes all timing risk"],"whenToPreferThis":"Choose this endpoint when you need a fast, cheap ($0.001 USDC), deterministic estimate of block confirmation time without setting up RPC infrastructure or live chain feeds. Ideal for scheduling agent sleeps, SLA preflight checks, and confirmation-target planning where advisory math is sufficient and no live node access is available.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:41.586Z","isFirstParty":false}