# x402scan Merchant Transaction History

> x402scan Merchant Transaction History 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-14).

Returns a paginated list of on-chain x402 payment transfers where a specified merchant address is the recipient

## Facts

- Endpoint: GET https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/merchants/:address/transactions
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402scan-j55w7ornb-merit-systems-vercel-app-91384f0e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fk7vKfKTNMuyFGgqsCFBA

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-91384f0e
```

Example prompt: Show me the last 30 days of incoming x402 payment transactions for merchant address 0x1234abcd on the Base chain, sorted by amount descending, 20 results per page starting at page 0.

## When to prefer this

Use this endpoint when you need transaction history specifically from the perspective of a merchant (recipient), with pagination and filtering support. Prefer over wallet-level endpoints when you only care about incoming payments to a known merchant address on the x402 network. Ideal for merchant dashboards, revenue auditing, or monitoring payment inflows.

## Known failure modes

- Invalid or malformed merchant address returns 400 or empty results
- Unsupported chain value returns validation error
- page_size outside 1–100 range rejected
- timeframe value not in allowed set (1,7,14,30) may return error or be ignored
- Payment not made (HTTP 402) if USDC not provided
- No transactions found returns empty list with 200

## How this service works

Paginated transfers where merchant is recipient

## Output

A paginated list of on-chain transfer records where the given merchant address is the payment recipient, including asset type, amount, sender, and timestamp. Results are filterable by chain (base or solana), sortable by time or amount, and support configurable page size (1–100) and lookback timeframe (1, 7, 14, or 30 days).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "page": 0,
   "chain": "base",
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
   "page_size": 10
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402scan-j55w7ornb-merit-systems-vercel-app-91384f0e/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)