# WalletLens TxLens Multi-Chain Transaction History

> WalletLens TxLens Multi-Chain Transaction History is a paid API for AI agents from walletlens.wallyweb.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns enriched, categorized EVM wallet transaction history across multiple chains with decoded transfers, labels, and insights

## Facts

- Endpoint: GET https://walletlens.wallyweb.com/tx-history
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/walletlens-wallyweb-com-262f1204
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hHS9HWDDpW5xObKZKN_mZ

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 walletlens-wallyweb-com-262f1204
```

Example prompt: Pull the last 30 days of enriched transaction history for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base and Ethereum, showing up to 50 transactions with all categories included.

## When to prefer this

Choose this endpoint when you need enriched, decoded, and categorized transaction history for an EVM wallet across Base and Ethereum, especially when raw RPC data is insufficient and you want labeled transfers, asset names, token IDs, and decoded call data in a single normalized response. Prefer over raw node queries when agent-ready structured output with insights is needed.

## Known failure modes

- Invalid wallet address format (not matching ^0x[a-fA-F0-9]{40}$) returns a 400 error
- Unsupported chain slug returns an error or empty results
- Payment failure via x402 protocol results in 402 response before data is returned
- Requested limit exceeds maximum of 100, clamped or rejected
- No transactions found for the address/chain/category combination returns empty transactions array
- Rate limiting or Alchemy backend downtime causes 500 or timeout

## How this service works

TxLens enriched multi-chain transaction history with categorization and insights

## Output

A JSON object containing: the queried wallet address, timestamp, list of enriched transaction objects (each with hash, from/to, asset, value, chain, decoded data, type labels), a summary object, pagination metadata, and the underlying provider (Alchemy).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "days": 30,
   "limit": 50,
   "chains": "base,ethereum",
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
   "category": "all"
  }
 }
}
```

## 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": [
      "address"
     ],
     "properties": {
      "days": {
       "type": "integer",
       "default": 30,
       "maximum": 365,
       "minimum": 1,
       "description": "Requested lookback window. Currently reported as intent while newest transfers are fetched."
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 100,
       "minimum": 1,
       "description": "Maximum enriched transfer rows to return."
      },
      "chains": {
       "type": "string",
       "default": "base,ethereum",
       "description": "Comma-separated supported chain slugs."
      },
      "address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "EVM wallet address."
      },
      "category": {
       "enum": [
        "all",
        "external",
        "internal",
        "erc20",
        "erc721",
        "erc1155"
       ],
       "type": "string",
       "default": "all",
       "description": "Alchemy transfer category filter."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "timestamp",
      "chains",
      "request",
      "summary",
      "transactions",
      "pagination",
      "provider",
      "note"
     ],
     "properties": {
      "note": {
       "type": "string"
      },
      "chains": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "address": {
       "type": "string"
      },
      "request": {
       "type": "object"
      },
      "summary": {
       "type": "object"
      },
      "provider": {
       "type": "string",
       "const": "alchemy"
      },
      "timestamp": {
       "type": "string",
       "format": "date-time"
      },
      "pagination": {
       "type": "object"
      },
      "transactions": {
       "type": "array
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "_truncated",
  "_originalSize"
 ],
 "properties": {
  "_truncated": {
   "type": "boolean"
  },
  "_originalSize": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/walletlens-wallyweb-com-262f1204/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from walletlens.wallyweb.com](https://www.zero.xyz/host/walletlens.wallyweb.com/llms.txt)