# Vibe Springs Agent Spend Report

> Vibe Springs Agent Spend Report is a paid API for AI agents from vibesprings.net, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-13).

Resolves on-chain USDC outflows for an EVM wallet to named merchants and services by matching transactions against Bazaar discovery catalogs, returning a spend report in JSON or PDF format.

## Facts

- Endpoint: GET https://vibesprings.net/api/report/agent-spend
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibe-springs-agent-spend-report-a8ec5ae5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rRFQaRkc07W4z26qBcFfb

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 vibe-springs-agent-spend-report-a8ec5ae5
```

Example prompt: Pull a 30-day USDC spend report for my agent wallet 0x3fA2b8E1c9D04aB5d6F7e8C1234567890abcdef1 and resolve all the outflows to merchant and service names — give me the JSON format.

## When to prefer this

Use this endpoint when an AI agent or user needs to audit, reconcile, or report on USDC spending activity from an EVM wallet — especially when the goal is to resolve raw on-chain transaction hashes into human-readable merchant and service names. Particularly valuable for agents that themselves spend USDC via x402 micropayments and need spend accountability. Choose the PDF format when a shareable or archivable document is needed; choose JSON for programmatic downstream processing.

## Known failure modes

- Invalid or malformed EVM address returns a 400 error
- Days parameter outside 7–90 range returns a validation error
- No transactions found for address in the given window returns empty result set
- Unknown transactions not in Bazaar catalog may appear as unresolved entries
- PDF format incurs higher cost ($0.25); incorrect format param may result in unexpected billing
- Network or chain indexing delays may cause recent transactions to be missing

## How this service works

Resolves on-chain USDC outflows to named merchants and listed services by matching transactions against historical Bazaar discovery catalogs. Formats: json ($0.10) or publication-ready PDF ($0.25).

## Output

A structured report mapping each on-chain USDC outflow from the specified wallet to a named merchant or listed service, identified via historical Bazaar discovery catalogs. Returned as either a JSON object (at $0.10) or a publication-ready PDF (at $0.25), covering the requested time window (7–90 days, default 30).

## 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",
       "description": "History query window (7-90 days, default 30)"
      },
      "format": {
       "type": "string",
       "description": "Output format: 'json' ($0.10) or 'pdf' ($0.25)"
      },
      "address": {
       "type": "string",
       "description": "Target EVM wallet address to analyze"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "byDay": [
   {
    "day": "2026-07-03",
    "spend": 0.12
   }
  ],
  "window": {
   "days": 30,
   "since": "2026-06-03T18:00:00Z",
   "until": "2026-07-03T18:00:00Z"
  },
  "address": "0xadD4D5bA29334e472aD78d4584551864Fab92567",
  "txCount": 4,
  "anomalies": {
   "spendSpikes": [],
   "priceOutliers": [],
   "newMerchantsThisWindow": []
  },
  "byMerchant": [
   {
    "spend": 0.12,
    "txCount": 4,
    "services": [
     {
      "name": "weather",
      "calls": 4,
      "spend": 0.008,
      "resolution": "exact"
     }
    ],
    "merchantDomain": "vibesprings.net"
   }
  ],
  "unresolved": [],
  "processingTime": "125ms",
  "resolutionRate": 100,
  "totalSpendUsdc": 0.12
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibe-springs-agent-spend-report-a8ec5ae5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibesprings.net](https://www.zero.xyz/host/vibesprings.net/llms.txt)