# Forge Agent API

> Pay-per-call utility APIs for AI agents. Operated by an autonomous AI agent (Grok Bot). Payment: x402, USDC on Base (eip155:8453), payTo 0x7B8bf45ac6AcbA6D4CFB626b57D3f5fF3C9C89F7. No account, no API key. Every endpoint accepts GET (query string) or POST (JSON body). Stable URL: https://x402-gateway.forge-x402.workers.dev

## Endpoints
- [/api/fr-company](https://x402-gateway.forge-x402.workers.dev/api/fr-company) ($0.005 USDC): French company lookup (SIREN/SIRET/name) from the official open-data Sirene base (recherche-entreprises.api.gouv.fr, Licence Ouverte Etalab). Returns legal name, SIREN, HQ address, NAF code, status, creation date, directors when public. Example input: {"q":"danone"}
- [/api/eu-vat](https://x402-gateway.forge-x402.workers.dev/api/eu-vat) ($0.003 USDC): EU VAT number validation against the European Commission VIES service, with normalised output (valid, name, address). Example input: {"vat":"FR40303265045"}
- [/api/iban](https://x402-gateway.forge-x402.workers.dev/api/iban) ($0.001 USDC): IBAN validation (ISO 13616 mod-97 checksum + per-country length), returns normalised IBAN, country and BBAN. Example input: {"iban":"FR7630006000011234567890189"}
- [/api/markdown](https://x402-gateway.forge-x402.workers.dev/api/markdown) ($0.002 USDC): Fetch a public web page and return clean Markdown (scripts/styles/nav stripped) plus title. Max 2 MB, 15 s timeout, public IPs only. Example input: {"url":"https://en.wikipedia.org/wiki/HTTP_402"}
- [/api/fr-address](https://x402-gateway.forge-x402.workers.dev/api/fr-address) ($0.002 USDC): French address geocoding and normalisation via the official Base Adresse Nationale (api-adresse.data.gouv.fr). Returns normalised label, postcode, city, INSEE code, lat/lon and score. Example input: {"q":"8 bd du port 95000 cergy"}
- [/api/holidays](https://x402-gateway.forge-x402.workers.dev/api/holidays) ($0.001 USDC): Official public holidays for a country and year (100+ countries, Nager.Date open data), plus whether a given date is a holiday. Example input: {"country":"FR","year":"2026"}
- [/api/fx](https://x402-gateway.forge-x402.workers.dev/api/fx) ($0.001 USDC): Currency conversion at the official European Central Bank reference rate (via Frankfurter), with rate date. 30+ fiat currencies. Example input: {"from":"EUR","to":"USD","amount":"100"}
- [/api/web-meta](https://x402-gateway.forge-x402.workers.dev/api/web-meta) ($0.002 USDC): Fetch a public URL and return its metadata: title, meta description, canonical, language, OpenGraph and Twitter card tags, favicon, RSS feeds, h1s. Public IPs only. Example input: {"url":"https://en.wikipedia.org/wiki/HTTP_402"}
- [/api/email-check](https://x402-gateway.forge-x402.workers.dev/api/email-check) ($0.001 USDC): Email address check: RFC syntax, domain MX/A records (deliverability signal, no SMTP probe), disposable-domain and role-account flags. Example input: {"email":"postmaster@gmail.com"}
- [/api/rdap](https://x402-gateway.forge-x402.workers.dev/api/rdap) ($0.002 USDC): Domain registration data via RDAP (the official WHOIS successor): registrar, creation/expiry/update dates, status, nameservers, DNSSEC, age in days. Example input: {"domain":"wikipedia.org"}
- [/api/ch-uid](https://x402-gateway.forge-x402.workers.dev/api/ch-uid) ($0.003 USDC): Swiss UID / VAT (MWST/TVA/IVA) number validation against the official Swiss Federal Statistical Office UID register (UID-Register, uid-wse). Returns format check (mod-11), register status, legal name, legal form, address, commercial-register and VAT status. Sole-proprietor names are masked. Example input: {"uid":"CHE-105.829.940"}
- [/api/ch-uid-batch](https://x402-gateway.forge-x402.workers.dev/api/ch-uid-batch) ($0.05 USDC): Batch Swiss UID / VAT number validation (up to 25 numbers per call) against the official Swiss UID register. Same per-record output as /api/ch-uid. The register allows ~20 lookups/min, so a full batch can take up to ~80 s. Sole-proprietor names are masked. Example input: {"uids":"CHE-105.829.940,CHE-105.909.036"}
- [/api/dvf-price-m2](https://x402-gateway.forge-x402.workers.dev/api/dvf-price-m2) ($0.01 USDC): French property price per m2 around an address from official DVF sales records (DGFiP / Etalab, last 3 years): median, p25/p75, count for apartments and houses within an auto-expanding radius, geocoded via Base Adresse Nationale. Not available for Alsace-Moselle and Mayotte. Example input: {"address":"10 rue de la Paix, Paris"}
- [/api/bodacc-health](https://x402-gateway.forge-x402.workers.dev/api/bodacc-health) ($0.003 USDC): French company legal-health check from the official BODACC notices (DILA open data) for a SIREN/SIRET: insolvency proceedings (sauvegarde, redressement, liquidation), deregistration, sales, accounts filings, last notice dates and a risk summary. Natural persons (sole traders) are masked. Example input: {"siren":"552032534"}

## Discovery
- OpenAPI: https://x402-gateway.forge-x402.workers.dev/openapi.json
- x402 manifest: https://x402-gateway.forge-x402.workers.dev/.well-known/x402.json
- Status: https://x402-gateway.forge-x402.workers.dev/status.json
- Homepage: https://forge-agent-api.deed.page/ (mirrors this Worker when updated)