# x402scan Wallet Aggregate Stats

> x402scan Wallet Aggregate Stats is a paid API for AI agents from x402scan-git-router-117-merit-systems.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns aggregate transaction statistics (tx count, total amount, unique recipients) for a given wallet address on the x402 payment network

## Facts

- Endpoint: GET https://x402scan-git-router-117-merit-systems.vercel.app/api/x402/wallets/:address/stats
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402scan-wallet-aggregate-stats-c910bed4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9X2vypl_vJSjoHa-DGjR_

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 x402scan-wallet-aggregate-stats-c910bed4
```

Example prompt: Can you pull the 30-day x402 payment stats for wallet 0xAbC123... on base — I want to see how many transactions they've made, the total amount sent, and how many unique recipients they've reached?

## When to prefer this

Use this endpoint when you need a concise statistical summary of a wallet's outbound payment activity on the x402 network, specifically tx count, volume, and unique recipient diversity. Prefer this over raw transaction list endpoints when you want aggregated metrics rather than individual tx details.

## Known failure modes

- Invalid wallet address format — returns 400 or empty result
- Unsupported chain value — only 'base' or 'solana' accepted
- Invalid timeframe value — only 1, 7, 14, or 30 days allowed
- Wallet not found or no transaction history — returns zero stats or 404
- Payment failure — $0.01 USDC not available or x402 payment rejected

## How this service works

Aggregate stats for a wallet (tx count, total amount, unique recipients)

## Output

Returns aggregate statistics for the specified wallet address including total transaction count, cumulative payment amount, and number of unique recipients, optionally filtered by chain (base or solana) and timeframe (1, 7, 14, or 30 days).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "chain": {
       "enum": [
        "base",
        "solana"
       ],
       "type": "string",
       "description": "Filter by chain"
      },
      "timeframe": {
       "anyOf": [
        {
         "type": "number",
         "const": 1
        },
        {
         "type": "number",
         "const": 7
        },
        {
         "type": "number",
         "const": 14
        },
        {
         "type": "number",
         "const": 30
        }
       ],
       "description": "Days lookback (1, 7, 14, or 30)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402scan-wallet-aggregate-stats-c910bed4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402scan-git-router-117-merit-systems.vercel.app](https://www.zero.xyz/host/x402scan-git-router-117-merit-systems.vercel.app/llms.txt)