Transaction status / confirmation API

Check whether a transaction confirmed: success vs reverted, confirmations, block, gas used, from/to/value — in one call. The primitive a payments agent polls right after sending funds.

Price$0.01per request

MethodPOST

Route/v1/chain/tx-status

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache15s public

chaintransactionreceiptconfirmationpayments

API URLhttps://x402.hexl.dev/v1/chain/tx-status

Integration docs

Example request

{
  "hash": "0xabababababababababababababababababababababababababababababababab",
  "chain": "base"
}

Example response

{
  "hash": "0xabababababababababababababababababababababababababababababababab",
  "chain": "base",
  "status": "success",
  "confirmations": 12,
  "blockNumber": 18000000,
  "from": "0x1111111111111111111111111111111111111111",
  "to": "0x2222222222222222222222222222222222222222",
  "valueEth": "0.050000",
  "gasUsed": 21000,
  "interpretation": "Confirmed and successful (12 confirmations).",
  "checkedAt": "2026-06-02T00:00:00.000Z"
}

Input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "ethereum"
      ],
      "default": "base"
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "hash",
    "chain",
    "status",
    "confirmations",
    "interpretation"
  ],
  "properties": {
    "hash": {
      "type": "string"
    },
    "chain": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "reverted",
        "pending",
        "not-found"
      ]
    },
    "confirmations": {
      "type": "number"
    },
    "blockNumber": {
      "type": [
        "number",
        "null"
      ]
    },
    "from": {
      "type": [
        "string",
        "null"
      ]
    },
    "to": {
      "type": [
        "string",
        "null"
      ]
    },
    "valueEth": {
      "type": [
        "string",
        "null"
      ]
    },
    "gasUsed": {
      "type": [
        "number",
        "null"
      ]
    },
    "interpretation": {
      "type": "string"
    },
    "checkedAt": {
      "type": "string"
    }
  }
}