# Transaction Status by Hash and Chain

> Transaction Status by Hash and Chain is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-14).

Retrieves transaction receipt status, success/failure flag, and execution error details for a given transaction hash on a specified blockchain

## Facts

- Endpoint: GET https://api.x402node.dev/contract/tx-status
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/transaction-status-by-hash-and-chain-4ae5a2b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0GR5_uat5WMi4pShwprkY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability transaction-status-by-hash-and-chain-4ae5a2b9
```

Example prompt: Did my transaction succeed? The tx hash is 0x4a3b2c1d... on Base — can you check if it confirmed and whether there was any execution error?

## When to prefer this

Use this endpoint when you need to confirm whether an on-chain transaction succeeded or failed after broadcasting, or when debugging a reverted smart contract call and need the execution error message. Prefer this over manually querying a block explorer when you need a structured, programmatic response with explicit error flags rather than parsing raw explorer HTML or JSON.

## Known failure modes

- Transaction hash not found on specified chain — returns not found or null receipt
- Invalid or malformed transaction hash — returns validation error
- Chain not supported — returns unsupported chain error
- Block explorer API key rate limit or outage — returns upstream error
- Transaction still pending (not yet mined) — receipt may be empty or null

## How this service works

Transaction status by hash and chain from a block explorer behind an API key: receipt success or failure, execution error flag and error description. For confirming and debugging transactions. transaction status, tx receipt, did tx succeed, execution error, tx confirmation Accepts payment on Base or Solana — either network works.

## Output

Returns the transaction receipt status (success or failure), an execution error flag indicating whether the transaction reverted, and a human-readable error description if available — allowing the agent to confirm finality or diagnose the cause of failure.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "txhash"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "default ethereum"
      },
      "txhash": {
       "type": "string",
       "description": "transaction hash 0x... 64 hex"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/transaction-status-by-hash-and-chain-4ae5a2b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)