# AgentAudit — Full API Documentation

> x402 settlement analytics. Protocol: x402 v2. Networks: Base + Solana (payment); Base (index).

Coverage: every wallet that a CDP Bazaar (agentic.market) listing names as its Base USDC payTo, refreshed daily, indexed from 2026-05-12. A settlement is a USDC transferWithAuthorization (EIP-3009) into such a wallet, matched to the payer's AuthorizationUsed log in the same transaction. Plain USDC transfers are excluded. Solana is not indexed. Totals are aggregates: AgentAudit does not store individual settlements beyond the latest 50 (/v1/flow).

## Endpoints

### GET /v1/trending
- Price: $0.02 (20000 atomic USDC)
- Top x402 services by on-chain settlement volume (Base) over 24h/7d/30d/90d/all.

### GET /v1/seller/:address
- Price: $0.02 (20000 atomic USDC)
- x402 seller profile on Base: settlements, volume, unique and external buyers, 30-day revenue trend.

### GET /v1/buyer/:address
- Price: $0.02 (20000 atomic USDC)
- x402 buyer profile on Base: spend, transaction count and sellers paid.

### GET /v1/flow
- Price: $0.02 (20000 atomic USDC)
- Latest indexed x402 settlements on Base, newest first.

### GET /v1/stats
- Price: $0.02 (20000 atomic USDC)
- Index-wide totals: settlements, volume, unique/external buyers, coverage and freshness.

### POST /v1/receipt
- Price: $0.05 (50000 atomic USDC)
- Verified spending report: POST up to 20 Base tx hashes, get which were x402 settlements, to whom, and how much.

### GET /v1/discover
- Price: $0.01 (10000 atomic USDC)
- x402 services ranked by 30-day on-chain settlement volume, optionally by category.

### GET /health
- Free. Returns { service: "AgentAudit", status: "ok" }

## Authentication

### x402 (recommended for agents)
1. Make the request without payment
2. Read the 402 body or PAYMENT-REQUIRED header (base64 JSON)
3. Sign the payment (EIP-3009 on Base, SPL transfer on Solana)
4. Retry with PAYMENT-SIGNATURE (or X-PAYMENT); settlement happens only for 2xx/3xx answers

### API Key
Header: Authorization: Bearer aa_live_YOUR_KEY

## Payment Details
- Asset: USDC (6 decimals)
- Solana payTo: GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- Base payTo: 0x318A4B4764eb37c3FCBcE434713128143815FD57
- Solana feePayer: resolved dynamically from GET /platform/v2/x402/supported (CDP fee-payer pool rotates; do not hardcode)

## Provider
Waltsoft · https://waltsoft.net