{
  "format": "delx/intent-card/v1",
  "id": "confirmations-needed-api",
  "intent": "Confirmations Needed for an agent workflow",
  "title": "Confirmations Needed API for agents",
  "description": "Compute confirmations remaining from head and inclusion block. Call when progress bars and readiness gates for deposit/finality logic. Returns confirmations observed vs needed 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.",
  "keywords": [
    "Confirmations Needed API",
    "Confirmations Needed for agents",
    "pay per result API",
    "x402 API",
    "no API key"
  ],
  "updated_at": "2026-08-23",
  "canonical_url": "https://commerce.delx.ai/intents/confirmations-needed-api",
  "machine_url": "https://commerce.delx.ai/intents/confirmations-needed-api.json",
  "recommendation": {
    "tool_name": "util_confirmations_needed",
    "service_name": "Confirmations Needed",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/confirmations-needed",
    "price_usdc": "0.001",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "tx_block": {
          "description": "Input field: tx block.",
          "type": "integer"
        },
        "head_block": {
          "description": "Input field: head block.",
          "type": "integer"
        },
        "target": {
          "description": "Input field: target.",
          "type": "integer"
        }
      },
      "required": [
        "tx_block",
        "head_block",
        "target"
      ],
      "additionalProperties": true
    },
    "example_input": {
      "tx_block": 100,
      "head_block": 105,
      "target": 12
    },
    "example_output": {
      "schema": "delx/util-confirmations-needed/v1",
      "confirmations": 6,
      "target": 12,
      "remaining": 6,
      "done": false
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/confirmations-needed -m POST -H 'x-delx-source: intent-card-confirmations-needed-api' --max-amount 0.001 -b '{\"tx_block\":100,\"head_block\":105,\"target\":12}'",
      "max_amount_usdc": "0.001"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-confirmations-needed-api"
  },
  "evidence": {
    "paid_openapi": "https://api.delx.ai/openapi.x402.json",
    "governed_portfolio": "https://api.delx.ai/x402-portfolio.json",
    "live_contract": "https://api.delx.ai/api/v1/x402/confirmations-needed"
  }
}