# agent402.tools My Usage History

> agent402.tools My Usage History is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns the calling wallet's own API usage history — totals, per-tool counts, per-chain breakdown, and recent receipts — authenticated solely by the x402 micropayment itself.

## Facts

- Endpoint: POST https://agent402.tools/api/my-usage
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-my-usage-history-b7d54e18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qZ0W30vgp9RcAPZsgyeYm

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 agent402-tools-my-usage-history-b7d54e18 -d '<json body>'
```

Example prompt: Show me my agent402 usage for the last 7 days — how many calls I made per tool and a breakdown by chain — and return my 20 most recent receipts.

## When to prefer this

Use this endpoint when an agent or user wants to inspect their own historical API usage and spend on the agent402.tools platform, authenticated purely by their wallet's x402 payment — no OAuth, no API key, no signup required. Prefer over generic analytics tools when the context is specifically micropayment-keyed identity and per-tool receipt history on the x402 network.

## Known failure modes

- Invalid days value outside 1-365 range returns a validation error
- Invalid limit value outside 1-200 range returns a validation error
- Missing or invalid x402 payment header results in a 402 Payment Required response
- No usage history found for wallet returns empty totals and empty receipt list
- Network timeout or upstream database error returns a 5xx error

## How this service works

Your own purchase history, keyed to the wallet that pays for the call - no wallet parameter, no signup: the x402 payment IS the identity, so nobody can read another wallet's profile. Returns totals, per-tool counts, per-chain breakdown, and recent receipts with settle tx hashes (independently verifiable on-chain). Requires an EIP-3009 payment (USDC on Base, Polygon, or Arbitrum); Solana/Stellar payments carry no signed payer the server can verify.

## Output

Returns aggregated usage statistics for the paying wallet: total call counts and spend, per-tool breakdowns, per-chain spend distribution, and a list of recent receipt records (up to the requested limit). No wallet parameter is needed; identity is derived from the x402 payment credential.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "number",
   "description": "Aggregation window in days, 1-365 (default 30). The recent list is always the latest rows regardless."
  },
  "limit": {
   "type": "number",
   "description": "Max recent receipts to return, 1-200 (default 50)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 30,
  "note": "Every USDC row keeps its settle tx - verifiable on-chain.",
  "bySlug": [
   {
    "usd": 0.012,
    "slug": "hash",
    "calls": 12,
    "lastAt": "2026-07-09T00:00:00.000Z"
   }
  ],
  "recent": [
   {
    "at": "2026-07-09T00:00:00.000Z",
    "tx": "0x…",
    "slug": "hash",
    "network": "base",
    "priceUsd": 0.001
   }
  ],
  "totals": {
   "calls": 42,
   "lastAt": "2026-07-09T00:00:00.000Z",
   "firstAt": "2026-07-01T00:00:00.000Z",
   "paidUsd": 1.234
  },
  "wallet": "0x902dcf34e53695bdea2ffb354b1a2e58bd598256",
  "byNetwork": {
   "base": {
    "usd": 1.2,
    "calls": 40
   },
   "polygon": {
    "usd": 0.034,
    "calls": 2
   }
  },
  "persistent": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-my-usage-history-b7d54e18/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)