{"uid":"cap_cNL71OFBzzBSmZWKWT_hO","slug":"delx-commerce-blockchain-confirmations-needed-calculator-43ff5958","name":"Delx Commerce — Blockchain Confirmations Needed Calculator","description":"Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.","url":"https://commerce.delx.ai/api/v1/x402/confirmations-needed?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"integer","description":"Input field: target."},"tx_block":{"type":"integer","description":"Input field: tx block."},"head_block":{"type":"integer","description":"Input field: head block."}}},"responseSchema":{"type":"json","example":{"done":false,"schema":"delx/util-confirmations-needed/v1","target":12,"remaining":6,"confirmations":6}},"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_PiQbZqXF0o4dyJl3EflTJ","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":"Calculates how many additional block confirmations are needed before a blockchain transaction is considered final, given a target confirmation count and current block heights.","exampleAgentPrompt":"Check how many more block confirmations my transaction needs to be final — it was included in block 21500000, the current head block is 21500006, and I need 12 confirmations total.","exampleUseCases":[{"title":"Waiting for deposit to clear","prompt":"My deposit transaction landed in block 19800000 and the chain is currently at block 19800004 — I need 10 confirmations before I can proceed. How many more confirmations do I still need?"},{"title":"DeFi settlement readiness check","prompt":"I'm waiting on a DeFi swap to settle — it was mined at block 22100050, the current head is 22100058, and the protocol requires 12 confirmations. Are we there yet, and how many blocks are left?"},{"title":"Cross-chain bridge transfer monitoring","prompt":"A bridge transfer was included in block 20000100, the latest block is 20000107, and we need 15 confirmations for the bridge to release funds. Can you tell me how many confirmations are still remaining?"}],"resultDescription":"Returns a JSON object indicating whether the required confirmation threshold has been reached (done: true/false), the target number of confirmations, how many confirmations have occurred so far, and how many more are still needed (remaining). Uses schema identifier 'delx/util-confirmations-needed/v1'.","failureModes":["Missing required fields (target, tx_block, head_block) result in validation errors","head_block less than tx_block yields nonsensical or negative remaining values","Non-integer input for block fields causes schema rejection","Network or payment (x402) failure returns 402 Payment Required if USDC payment is not processed"],"whenToPreferThis":"Use this endpoint when you need a lightweight, pay-per-call computation to determine blockchain transaction finality without running a full node. Ideal for agents monitoring settlement status in DeFi, bridge, or exchange workflows where you know the transaction block, current head block, and required confirmation threshold. Prefer this over custom RPC calls when you want verifiable, priced delivery with no signup friction via the x402 protocol on Base or Solana.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:53:43.705Z","isFirstParty":false,"canonicalSlug":"delx-commerce-blockchain-confirmations-needed-calculator-43ff5958"}