# x402lint — agent skill

Conformance scanner + graded discovery directory for x402 sellers — free cached reports, $0.05 priority fresh scans, paid machine-tier directory export and change feed. Per-call USDC pricing, no signup.

**When to use:** x402 seller conformance: lint any x402 API origin (free cached reports), browse the graded discovery directory, or consume it programmatically via the paid export and change feed.

No signup. No API key. Pay per call with USDC via x402 (Base).

## Endpoints and prices
| Method | Path | Price | What you get |
|--------|------|-------|--------------|
| GET | /v1/status | free | FREE scan status lookup |
| GET | /v1/checks | free | FREE check catalog |
| POST | /v1/scan | $0.05 | Priority fresh re-scan |
| GET | /v1/report | free | FREE cached full report |
| GET | /v1/directory/export | $0.1 | Full directory export (machine tier) |
| GET | /v1/changes | $0.03 | Directory change feed |
| GET | /v1/directory | free | FREE graded directory |
| GET | /v1/featured | free | FREE featured (recent A-grades) |
| GET | /v1/project | free | FREE single project record |
| POST | /v1/verify/start | free | FREE start ownership verification |
| POST | /v1/verify/confirm | free | FREE confirm ownership verification |
| POST | /v1/listing | free | FREE listing control (verified owners) |

## Quickstart (2 minutes)
1. Probe any paid route unauthenticated — you get an HTTP 402 challenge with machine-readable `accepts`:
   `curl -s https://api.x402lint.dev/v1/scan`
2. Pay and retry with any x402 client, e.g.:
   `npx agentcash fetch "https://api.x402lint.dev/v1/scan"`
   or `@x402/fetch` (npm install @x402/fetch @x402/evm viem).
3. Response includes `charged: true` only when work succeeded — failed calls are never charged.

## Free routes (no payment)
- GET /v1/status — FREE scan status lookup
- GET /v1/checks — FREE check catalog
- GET /v1/report — FREE cached full report
- GET /v1/directory — FREE graded directory
- GET /v1/featured — FREE featured (recent A-grades)
- GET /v1/project — FREE single project record
- POST /v1/verify/start — FREE start ownership verification
- POST /v1/verify/confirm — FREE confirm ownership verification
- POST /v1/listing — FREE listing control (verified owners)

## Suggested schedule
Weekly: re-scan your own origin so your directory grade stays fresh.

## If your wallet is empty
Ask your human operator to fund your Base (eip155:8453) wallet with USDC, or see the API-key alternative in `https://api.x402lint.dev/llms.txt`.

## More surfaces
- `https://api.x402lint.dev/llms.txt` · `https://api.x402lint.dev/llms-full.txt` · `https://api.x402lint.dev/openapi.json`
- `https://api.x402lint.dev/.well-known/x402` · `https://api.x402lint.dev/.well-known/x402-resources.json` · `https://api.x402lint.dev/.well-known/agent-card.json`
- Terms: `https://api.x402lint.dev/terms.txt` — Contact: jcislo918@gmail.com