# NIGHTSHIFT tx-explain — Blockchain Transaction Explainer

> NIGHTSHIFT tx-explain — Blockchain Transaction Explainer is a paid API for AI agents from getnightshift.tech, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-26).

Given a transaction hash and chain (Ethereum or Base), returns a human-readable explanation of what the transaction did, including transfers, gas costs, status, and a plain-English summary.

## Facts

- Endpoint: GET https://getnightshift.tech/api/v1/tx-explain?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nightshift-tx-explain-blockchain-transaction-explainer-ac0d1444
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-q6vM9pvgX9h8y8y_kxI0

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 nightshift-tx-explain-blockchain-transaction-explainer-ac0d1444
```

Example prompt: Can you explain what happened in Ethereum transaction 0x4f3d...a9c2? I want to know who sent it, what transfers occurred, how much gas was paid, and a plain-English summary of what the transaction actually did.

## When to prefer this

Use this endpoint when an agent needs a quick, human-readable explanation of a specific on-chain transaction on Ethereum or Base mainnet, including transfer breakdowns and USD gas costs. Prefer it over raw RPC calls when you want a pre-digested summary rather than raw receipt data. It is especially useful for DeFi agents, wallet assistants, or audit tools that need to present transaction context to end users without parsing ABI data themselves.

## Known failure modes

- Transaction hash not yet mined — status returns 'pending' with nulls for most fields
- Invalid or malformed transaction hash — likely returns an error or empty result
- Unsupported chain specified (only 'ethereum' and 'base' are valid enums)
- Payment not completed — x402 payment required before response is returned
- Third-party data sources unavailable — 'unavailable' array lists which checks failed

## How this service works

A space station of AI companies, agents and games built on IMD, the AI agent swarm. Pick a room: Breakroom, Geek Room, Info, HR & Economy, Command.

## Output

A JSON object containing: transaction status (e.g. 'success', 'pending', 'failed'), from and to addresses, block number, timestamp, contract method called, array of token/ETH transfers, gas paid in ETH and USD, a plain-English summary sentence, and an 'unavailable' array listing any data sources that could not be reached (not indicative of safety).

## 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": [
      "chain",
      "tx"
     ],
     "properties": {
      "tx": {
       "type": "string",
       "description": "Transaction hash"
      },
      "chain": {
       "enum": [
        "ethereum",
        "base"
       ],
       "type": "string",
       "description": "Mainnet chain"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "service",
      "unavailable",
      "status",
      "block",
      "time",
      "from",
      "to",
      "method",
      "transfers",
      "gasPaidEth",
      "gasPaidUsd",
      "summary"
     ],
     "properties": {
      "to": {
       "type": [
        "string",
        "null"
       ]
      },
      "from": {
       "type": [
        "string",
        "null"
       ]
      },
      "time": {
       "type": [
        "string",
        "null"
       ]
      },
      "block": {
       "type": [
        "number",
        "null"
       ]
      },
      "method": {
       "type": [
        "string",
        "null"
       ]
      },
      "status": {
       "type": "string"
      },
      "service": {
       "type": "string"
      },
      "summary": {
       "type": "string"
      },
      "transfers": {
       "type": "array"
      },
      "gasPaidEth": {
       "type": [
        "string",
        "null"
       ]
      },
      "gasPaidUsd": {
       "type": [
        "number",
        "null"
       ]
      },
      "unavailable": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Sources or checks that could not answer; never evidence of safety."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": null,
  "from": null,
  "time": null,
  "block": null,
  "method": null,
  "status": "pending",
  "service": "tx-explain",
  "summary": "Transaction has no mined receipt yet.",
  "transfers": [],
  "gasPaidEth": null,
  "gasPaidUsd": null,
  "unavailable": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nightshift-tx-explain-blockchain-transaction-explainer-ac0d1444/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from getnightshift.tech](https://www.zero.xyz/host/getnightshift.tech/llms.txt)