# x402 Wallet Spend Lookup

> x402 Wallet Spend Lookup is a paid API for AI agents from data.kagurazaka.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Returns on-chain USDC spend breakdown for a wallet address on x402 APIs over a configurable period, including totals, per-seller, per-day, and individual payment records.

## Facts

- Endpoint: GET https://data.kagurazaka.dev/v1/spend?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-wallet-spend-lookup-e08f692b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XnTuRVkvAF9lftflftlPi

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 x402-wallet-spend-lookup-e08f692b
```

Example prompt: Show me the x402 API spending breakdown for my wallet 0x1234...abcd over the last 14 days — I want to see totals, which sellers I paid the most, and the day-by-day breakdown.

## When to prefer this

Use this endpoint when you need on-chain verified spend data for a specific wallet's x402 API usage on Base, broken down by seller and time. Prefer this over off-chain analytics when auditability and chain-sourced accuracy matter, or when you need per-seller attribution for cost tracking of x402 API calls.

## Known failure modes

- Missing or invalid payer address returns an error
- Days parameter outside 1-14 range may be rejected or clamped
- Wallet with no x402 activity returns zero totals
- On-chain data may have brief indexing lag
- Rate limiting or payment required if x402 payment not provided

## How this service works

Data about the x402 market: the CDP Bazaar's listings, sellers, prices and categories, new listings and price changes from snapshots every 6 hours, uptime we measure for every paid listing, and x402 spending of any wallet and revenue of any seller on Base.

## Output

Returns a JSON object with: total_usd (aggregate spend), payments (total call count), by_day (array of date/usd/payments), by_seller (array of pay_to address, associated API origins, usd spent, payment count). Non-x402 USDC transfers are counted separately.

## 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": [
      "payer"
     ],
     "properties": {
      "days": {
       "type": "integer",
       "description": "period in days (1-14, default 7)"
      },
      "payer": {
       "type": "string",
       "description": "the paying wallet address (0x...)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "by_day": {},
      "payments": {},
      "by_seller": {},
      "total_usd": {}
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "by_day": [
   {
    "usd": 0.05,
    "date": "2026-10-24",
    "payments": 8
   }
  ],
  "payments": 8,
  "by_seller": [
   {
    "usd": 0.03,
    "pay_to": "0x...",
    "origins": [
     "https://api.example"
    ],
    "payments": 3
   }
  ],
  "total_usd": 0.05
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-wallet-spend-lookup-e08f692b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.kagurazaka.dev](https://www.zero.xyz/host/data.kagurazaka.dev/llms.txt)
