# x402scan Merchant Aggregate Stats

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

Returns aggregate on-chain statistics for a specific merchant address, including transaction count, total volume, and unique payer counts, optionally filtered by chain and timeframe.

## Facts

- Endpoint: GET https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/merchants/: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-j55w7ornb-merit-systems-vercel-app-adcaea93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xBhQAvQX6jPsxPlB3q_5g

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-j55w7ornb-merit-systems-vercel-app-adcaea93
```

Example prompt: Show me the aggregate stats for merchant address 0xABC123 on Base over the last 30 days — total transaction count, volume, and unique payers.

## When to prefer this

Use this endpoint when you need a rolled-up summary of a specific merchant's payment activity on-chain (x402 protocol), such as total volume, transaction count, or unique payer count, and don't need individual transaction details. Prefer this over the transactions list endpoint when aggregated metrics are sufficient.

## Known failure modes

- Invalid or unrecognized merchant address returns empty or null stats
- Unsupported chain value (not 'base' or 'solana') may return a validation error
- Unsupported timeframe value (not 1, 7, 14, or 30) may return an error or default behavior
- Merchant with no recorded transactions returns zero-value stats
- Payment of $0.01 USDC required; missing or failed x402 payment returns 402 error

## How this service works

Aggregate stats for a merchant

## Output

Returns aggregated statistics for the specified merchant address including total transaction count, cumulative payment volume, and number of unique payers, optionally scoped to a specific chain (base or solana) and a lookback timeframe of 1, 7, 14, or 30 days.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402scan-j55w7ornb-merit-systems-vercel-app-adcaea93/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402scan-j55w7ornb-merit-systems.vercel.app](https://www.zero.xyz/host/x402scan-j55w7ornb-merit-systems.vercel.app/llms.txt)