# Nightshift Labs Base Transaction Lookup

> Nightshift Labs Base Transaction Lookup is a paid API for AI agents from nightshift-x402.nightshift-labs.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-18).

Looks up and decodes a Base blockchain transaction by hash, returning sender, fee, status, and ERC-20 token transfer details including USDC impersonation warnings.

## Facts

- Endpoint: GET https://nightshift-x402.nightshift-labs.workers.dev/v1/base/tx?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nightshift-labs-base-transaction-lookup-ce40302f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P17-kUr1v0Rw86-lMJXbE

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-labs-base-transaction-lookup-ce40302f
```

Example prompt: Can you look up Base transaction 0x3a7f2e1d4b8c9f0e6a5d2b1c8e3f7a4d9b6c0e2f5a8d1b4c7e0f3a6d9b2c5e8 and tell me who sent it, what the status is, and whether any of the token transfers look suspicious?

## When to prefer this

Use this endpoint when you need to decode and inspect a specific Base blockchain transaction by its hash — especially when you need to verify whether ERC-20 token transfers (particularly USDC) are legitimate or spoofed. Prefer this over generic block explorers when you need machine-readable output with built-in fraud detection signals for token impersonation, suitable for automated agent workflows.

## Known failure modes

- Invalid or malformed transaction hash (not matching ^0x[0-9a-fA-F]{64}$) returns a validation error
- Transaction hash not found on Base returns a not-found error
- Network or RPC issues may cause timeouts or service unavailability
- Payment required (HTTP 402) if x402 USDC payment on Base is not provided or fails

## How this service works

Decode a Base transaction: status, block time, from/to, ETH value, fee, method selector and every ERC-20 transfer with symbol and human amount. Flags fake look-alike tokens (address-poisoning, e.g. a fake USDC with homoglyph characters).

## Output

A JSON object containing: the sender address (from), transaction status (success/failed), ETH fee paid (feeEth), and an array of ERC-20 token transfers each with amount, symbol, and an optional warning flag (e.g. IMPERSONATES_USDC_WITH_LOOKALIKE_CHARACTERS) if the token appears to be a fraudulent USDC impersonator.

## 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": [
      "hash"
     ],
     "properties": {
      "hash": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{64}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "from": "0x1da8…",
  "feeEth": "0.00000015",
  "status": "success",
  "erc20Transfers": [
   {
    "amount": "200.05",
    "symbol": "USDC",
    "warning": "IMPERSONATES_USDC_WITH_LOOKALIKE_CHARACTERS"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nightshift-labs-base-transaction-lookup-ce40302f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nightshift-x402.nightshift-labs.workers.dev](https://www.zero.xyz/host/nightshift-x402.nightshift-labs.workers.dev/llms.txt)
