# agentic-x402

> Pay-per-request document intelligence API.
> Scrub PII, verify completeness, assess risk, extract structured fields.
> Payments in USDC on Base via the x402 protocol. No subscriptions.

## What this API does

- **POST /scrub** — Remove or mask PII (email, CPF, CNPJ, phone, API keys). Regex + Claude AI hybrid. From $0.005 USDC per call.
- **POST /verify** — Verify document completeness and field presence. Returns score + per-field check results. From $0.010 USDC.
- **POST /assess** — Risk and quality assessment of business documents. Returns risk level + recommendations. From $0.030 USDC.
- **POST /extract** — Extract named fields from invoices, NF-e, contracts, receipts. From $0.015 USDC.

## Free endpoints (no payment required)

- **POST /preview** — Free regex-only scrub preview, max 300 characters. Returns scrubbed text + detected PII types + upgrade info.
- **GET /health** — Service liveness, uptime, per-route request counts and earned USDC.
- **GET /.well-known/x402.json** — Machine-readable payment terms and endpoint catalog.
- **GET /openapi.json** — OpenAPI 3.1 specification for all endpoints.

## How to pay (x402 protocol)

1. Call any paid endpoint without X-Payment header → receive HTTP 402 + JSON payment terms.
2. Sign an EIP-3009 USDC TransferWithAuthorization to the receiving address.
3. Retry the request with `X-Payment: <base64-encoded-signed-proof>` header.

## Client libraries

- JavaScript/TypeScript: `npm install x402` then `createPaymentHeader(account, 1, terms)`
- Docs: https://github.com/coinbase/x402

## Network

- Network: base-mainnet
- Receiving address: 0x2a4dcdf273be222903629ff3a2222065b017309d
- USDC contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Facilitator: https://x402.org/facilitator

## Base URL

http://romefeller.app

## Quick example (free)

```
POST http://romefeller.app/preview
Content-Type: application/json

{"text": "Contact joao@corp.com.br, CPF 123.456.789-00"}
```