# FLINTTECH x402 API

> Live Minneapolis construction permit leads, contractor permit history and website audits as clean JSON for AI agents. Pay per call in USDC on Base via x402: no API key, no signup, from $0.10.

Paid routes answer HTTP 402 with an x402 v2 payment requirement on Base mainnet (eip155:8453); pay and retry. Volume tiers: /leads/bulk, /contractor/batch and /audit/batch cost less per record than the single-call routes. Identical requests are served from a short cache (X-Cache header) for speed; every call is still paid.

## Endpoints
- [GET /report](https://flinttech-x402.onrender.com/report) — $0.05 USDC. Input: none. Agentic Commerce Report: current practical notes on x402 agent payments (USDC on Base) and pricing guidance for paid agent APIs. Returns JSON.
- [POST /analyze](https://flinttech-x402.onrender.com/analyze) — $0.25 USDC. Input: JSON {"query": string (required), "context": object (optional)}. Custom Analysis: ask a question about agent commerce, x402 monetization, API pricing or lead-gen; returns a JSON recommendation.
- [GET /leads](https://flinttech-x402.onrender.com/leads) — $0.25 USDC. Input: query: city=minneapolis, type (Res|Commercial|Plumbing|Mechanical|Wrecking|Site), since=YYYY-MM-DD, status, minValue, q (scope keyword), limit<=100. Metro Permit Leads: live Minneapolis construction permits (City open data) with job value, scope, address and the contractor who pulled it. Great for contractor/supplier sales prospecting.
- [GET /contractor](https://flinttech-x402.onrender.com/contractor) — $0.15 USDC. Input: query: name (required, partial match), since=YYYY-MM-DD. Contractor Permit History: a Minneapolis contractor's live permit count, total job value by trade, last permit and 10 most recent jobs (City open data). Vet or size a contractor.
- [GET /audit](https://flinttech-x402.onrender.com/audit) — $0.10 USDC. Input: query: url (required). Website & Local Presence Audit: fetches a business site live and returns a 0-100 score, issue list and checks (HTTPS, speed, title/meta, mobile, LocalBusiness schema, tap-to-call, Google Maps/Business Profile link, sitemap, security headers).
- [GET /leads/bulk](https://flinttech-x402.onrender.com/leads/bulk) — $1.00 USDC. Input: same query as /leads, limit<=500 (default 500, since defaults to 30 days ago). Bulk tier: up to 500 live Minneapolis permit leads in one call (about $0.002/lead vs $0.0025 at /leads).
- [POST /contractor/batch](https://flinttech-x402.onrender.com/contractor/batch) — $1.00 USDC. Input: JSON {"names": string[1-10], "since"?: "YYYY-MM-DD"}. Batch tier: permit history for up to 10 contractors in one call ($0.10/name vs $0.15).
- [POST /audit/batch](https://flinttech-x402.onrender.com/audit/batch) — $0.75 USDC. Input: JSON {"urls": string[1-10]}. Batch tier: website & local presence audits for up to 10 sites in one call ($0.075/site vs $0.10).
- [GET /premium](https://flinttech-x402.onrender.com/premium) — $0.01 USDC. Input: none. Cheapest paid call: a tiny JSON payload. Use it to test your x402 client end to end on Base mainnet for one cent.

## Free discovery
- [OpenAPI 3.1](https://flinttech-x402.onrender.com/openapi.json)
- [x402 discovery](https://flinttech-x402.onrender.com/.well-known/x402)
- [Health](https://flinttech-x402.onrender.com/health)
- [Agent manifest](https://flinttech-x402.onrender.com/.well-known/ai-plugin.json)

## Legal
- [Terms](https://flinttech-store.pages.dev/terms/) | [Privacy](https://flinttech-store.pages.dev/privacy/) | [Refunds](https://flinttech-store.pages.dev/refund/)
- Refunds: Calls are final once paid; a call that fails due to our error is refunded to the paying wallet if you email the tx hash to f1intt3ch@gmail.com within 7 days.

## How to pay
Use @x402/fetch (wrapFetchWithPayment) or any x402 v2 client with a Base wallet holding USDC. Settlement goes to 0x328c4Dbb5B9E0811835E7d8c58295857b4F7f7E5 via the Coinbase CDP facilitator. Listed in the CDP x402 Bazaar.