# x402-farm

> 75 pay-per-call APIs for AI agents — the deepest 🇫🇷 French business & open-data coverage in x402 (company/SIREN-SIRET, KYB, financial score, real-estate AVM, BODACC, cadastre, DVF, INSEE), plus 🇬🇧 UK Companies House, 🇺🇸 SEC EDGAR, and web tooling. x402 (USDC on Base/Polygon/Arbitrum), no account, no API key.

Machine-readable catalog: https://api.x-402.online/ (JSON) and https://api.x-402.online/openapi.json
Discovery: https://api.x-402.online/.well-known/x402 · https://api.x-402.online/.well-known/mcp · https://api.x-402.online/.well-known/agent-skills.json
Free previews (no payment): see /free/* routes below.

## Quickstart — first paid call in 60 seconds
Any x402 client works. With @x402/fetch (Node, a funded USDC wallet on Base):
```js
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
const f = wrapFetchWithPaymentFromConfig(fetch, { schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const r = await f("https://api.x-402.online/v1/weather?city=Paris"); // $0.003, settled on-chain
console.log(await r.json());
```
Cheapest probes: GET /v1/weather ($0.003) · /v1/crypto/price ($0.003) · /v1/dns ($0.005).
All /v1 routes accept BOTH GET (query params) and POST (JSON body).
Every 402 response includes `alternatives` (cheaper /partial version, free trial) when available.

## Residential-IP scraping (rare on x402)
extract / render / screenshot / pdf / links / meta run on a real Chromium behind a FRENCH
RESIDENTIAL IP — not a datacenter. They reach pages that block AWS/GCP/cloud ranges and
geo-restricted FR content, the same job Firecrawl/ScrapingBee charge much more for.
Example: POST /v1/extract {"url":"https://…"} ($0.005) -> clean markdown. Works via GET too.

## Cheapest LLM + search on x402
POST /v1/llm {"prompt":"…"} ($0.002, DeepSeek v4) — among the lowest $/call anywhere.
POST /v1/llm/pro ($0.006) for hard reasoning. GET /v1/search?q= ($0.003) real Google results.
GET /v1/search/news?q= ($0.003) fresh headlines. First daily call is free on all of these.

## Agent workflow — FR company due diligence in 3 calls (~$0.16)
1. GET /v1/fr/kyb/partial?q=<name> ($0.03) -> verdict + red-flag count. Stop if CONFORME and 0 flags.
2. GET /v1/fr/procedures-collectives?siren= ($0.03) -> insolvency history if flags > 0.
3. GET /v1/fr/kyb?siren= ($0.10) -> full dossier (officers, financials, VIES VAT) for the final report.

## Paid endpoints
- GET /v1/weather ($0.003): Worldwide weather: current conditions + 3-day forecast by lat/lon or city name. Query: ?city= or ?lat=&lon=
- GET /v1/crypto/price ($0.003): Spot prices + 24h change for any CoinGecko-listed tokens, multi-currency. Query: ?ids=bitcoin,ethereum&vs=usd,eur
- POST /v1/extract ($0.005): URL -> main content as clean markdown, from a FRENCH RESIDENTIAL IP + real Chromium (JS-rendered). Reaches sites that block datacenter/cloud IPs (Firecrawl/ScrapingBee territory) at a fraction of the price. Input: {url}
- POST /v1/render ($0.005): URL -> full HTML after JS execution, from a French residential IP + real browser (bypasses datacenter blocks). Input: {url}
- POST /v1/screenshot ($0.01): URL -> PNG screenshot from a French residential IP + real browser (renders sites that block cloud IPs). Input: {url, fullPage?}
- POST /v1/pdf ($0.01): URL -> A4 PDF from a French residential IP + real browser. Input: {url}
- POST /v1/links ($0.005): URL -> deduplicated links (internal/external + anchor text), fetched from a French residential IP. Input: {url}
- POST /v1/meta ($0.005): URL -> SEO meta, OpenGraph, canonical, JSON-LD, from a French residential IP + real browser. Input: {url}
- GET /v1/fr/entreprise ($0.02): French company lookup by name or SIREN/SIRET: officers, NAF, HQ, status. Query: ?q=
- GET /v1/fr/geocode ($0.005): Geocode any French address incl. overseas territories (lat/lon, score). Query: ?q=
- GET /v1/dns ($0.005): Full DNS records for a domain: A, AAAA, MX, TXT, NS, SPF. Query: ?domain=
- GET /v1/email/validate ($0.005): Email validation: syntax + domain MX check, no email sent. Query: ?email=
- GET /v1/fr/tva ($0.005): Compute French intra-EU VAT number from a SIREN (offline, instant). Query: ?siren=
- GET /v1/fr/vat-eu ($0.02): Validate any EU VAT number via the official VIES service, returns trader name/address. Query: ?vat=
- GET /v1/fr/commune ($0.005): French commune info: population, INSEE code, postal codes, EPCI, department, region, coords. Query: ?q= or ?cp=
- GET /v1/fr/reverse-geocode ($0.005): Reverse geocode lat/lon to a French address (incl. overseas). Query: ?lat=&lon=
- GET /v1/fr/jours-feries ($0.005): French public holidays for a year and zone (metropole, alsace-moselle, guadeloupe, etc.). Query: ?annee=&zone=
- GET /v1/fr/georisques ($0.02): Natural & technological risks for a French commune (flood, seismic, industrial...). Query: ?insee=
- GET /v1/fr/carburants ($0.01): Live fuel prices at stations near a French postal code (gazole, SP95/98, E85, GPL). Query: ?cp=
- GET /v1/fr/etablissements ($0.02): French company HQ + establishment counts by SIREN (SIRET, address, status). Query: ?siren=
- GET /v1/fr/association ($0.02): Search French associations (RNA) by name: SIREN, RNA id, creation date, city. Query: ?q=
- GET /v1/fr/dpe ($0.02): Energy performance diagnostics (DPE/GES labels) for dwellings in a French area. Query: ?insee= or ?cp=
- GET /v1/fr/vacances-scolaires ($0.005): French school holidays by zone and year. Query: ?zone=&annee=
- GET /v1/fr/ecoles ($0.01): French schools directory lookup by name or postal code (type, status, address, phone). Query: ?q= or ?cp=
- GET /v1/fr/iban ($0.005): Validate an IBAN (mod-97 checksum), returns country and French bank code. Query: ?iban=
- GET /v1/fr/codes-postaux ($0.005): Map a French postal code to its communes (name + INSEE code). Query: ?cp=
- GET /v1/fr/cadastre ($0.01): French cadastral parcel at given coordinates: parcel id, section, number, surface (IGN). Query: ?lat=&lon=
- GET /v1/fr/valeurs-foncieres ($0.02): Real French real-estate sale prices (DVF) for a commune: date, price, surface, type. Query: ?insee=&annee=
- GET /v1/fr/insee-commune ($0.01): INSEE commune stats: population, area, computed density, department, region, EPCI. Query: ?insee=
- GET /v1/fr/meteo ($0.005): Current weather + up to 7-day forecast for any coordinates (France & overseas), French descriptions. Query: ?lat=&lon=&jours=
- GET /v1/fr/rge ($0.02): RGE-certified renovation contractors near a French postal code (name, trade, phone, email). Query: ?cp=&domaine=
- GET /v1/fr/rge-check ($0.01): Check whether a French company (by SIRET) is RGE-certified, with its qualifications. Query: ?siret=
- GET /v1/fr/transport ($0.01): Public-transit & mobility open datasets for a French area with GTFS/NeTEx/GBFS feed URLs. Query: ?q=
- GET /v1/fr/irve ($0.01): EV charging stations in a French commune: operator, power, connectors, access, coords (IRVE). Query: ?insee=
- GET /v1/fr/bodacc ($0.02): BODACC legal announcements for a French company by SIREN (filings, sales, insolvency, changes). Query: ?siren=
- GET /v1/fr/bio ($0.02): Certified organic (AB) operators in France by department and/or text search: farms, processors, productions. Query: ?departement=&q=
- GET /v1/fr/entreprise-360/partial ($0.02): LITE version of entreprise-360 (identity, HQ city, establishments count, legal notices count). Try cheap, upgrade to /v1/fr/entreprise-360 for officers, finances, RGE. Query: ?q= or ?siren=
- GET /v1/fr/entreprise-360 ($0.04): Full French company report in ONE call: identity, VAT, HQ, officers, establishments, finances, legal notices (BODACC), RGE cert. Aggregates 3 sources. Free trial: /free/entreprise-360. Query: ?q= or ?siren=
- GET /v1/fr/estimation-immo ($0.05): Real-estate price estimate (AVM) computed from real DVF sale comparables: €/m² median + range and value for a surface. Free trial: /free/estimation-immo. Query: ?adresse=&surface=&type=appartement|maison
- GET /v1/fr/bilans ($0.06): French company annual accounts & financial statements (revenue, net income, capital) + list of filed accounts, via INPI RNE (auth-gated source). Query: ?siren=
- GET /v1/fr/procedures-collectives ($0.03): Is this French company in insolvency proceedings (sauvegarde, redressement, liquidation judiciaire)? Official BODACC court announcements: synthetic status, full judgment history, RCS deregistration flag. The #1 B2B check before signing. Query: ?siren=
- GET /v1/fr/score-entreprise/partial ($0.02): LITE version of score-entreprise: score 0-100 + level + insolvency count only. Upgrade to /v1/fr/score-entreprise for factor breakdown & financials. Query: ?q= or ?siren=
- GET /v1/fr/score-entreprise ($0.08): Company solidity/risk score 0-100 for a French company: crosses INPI financials (revenue/profit trend), BODACC legal proceedings, age, status. Replaces a paid solvency report. Free trial: /free/score-entreprise. Query: ?q= or ?siren=
- GET /v1/fr/analyse-immo/partial ($0.03): LITE version of analyse-immo: median price/m2, estimated value, investment score. Upgrade to /v1/fr/analyse-immo for energy, risks, demographics, yield. Query: ?adresse=&surface=
- GET /v1/fr/analyse-immo ($0.08): Real-estate investment scorecard for an address: DVF value estimate + energy (DPE) + natural risks + demographics + rental yield estimate. Query: ?adresse=&surface=&type=appartement|maison
- GET /v1/fr/kyb/partial ($0.03): LITE version of kyb: compliance verdict + VAT VIES validity + insolvency + red-flag count. Upgrade to /v1/fr/kyb for full dossier (officers, financials, flags detail). Query: ?q= or ?siren=
- GET /v1/fr/kyb ($0.10): Know-Your-Business compliance dossier for a French company in one call: identity, VAT + VIES validation, officers, financial health (INPI), legal proceedings (BODACC), risk verdict. Free trial: /free/kyb. Query: ?q= or ?siren=
- GET /v1/fr/etude-implantation ($0.12): Business location study: competitor saturation (same activity in commune), demographics, commercial real-estate prices, opportunity score. Query: ?activite=&commune=
- GET /v1/fr/reseau-dirigeant ($0.08): All French companies linked to a person (director search) with active/ceased flags and fraud-risk level. Query: ?nom=&prenom=
- GET /v1/fr/concurrents ($0.08): Competitive landscape of a French company: same-NAF rivals in its area ranked by revenue, with CA position. Query: ?q= or ?siren= &zone=departement|region
- GET /v1/fr/verif-artisan ($0.08): Verify a French contractor before hiring: company health, age, RGE certification, insolvency proceedings, trust level. Query: ?q= or ?siren=
- GET /v1/fr/valorisation ($0.10): Company valuation estimate from public financials (revenue & earnings multiples), with range. Query: ?q= or ?siren=
- GET /v1/uk/company ($0.02): UK company profile (Companies House): status, incorporation, SIC codes, registered office, accounts due dates, insolvency/charges flags. Query: ?q= or ?number=
- GET /v1/uk/officers ($0.02): UK company directors/officers (Companies House): name, role, appointment/resignation, nationality. Query: ?q= or ?number=
- GET /v1/uk/psc ($0.03): UK beneficial owners — Persons with Significant Control (Companies House), key for KYB/AML. Query: ?q= or ?number=
- GET /v1/uk/company-check ($0.08): UK company KYB verdict in one call: status, accounts/filing compliance, insolvency history, officers, beneficial owners. Query: ?q= or ?number=
- GET /v1/us/company ($0.02): US public company profile (SEC EDGAR): name, CIK, tickers, exchange, SIC, state, fiscal year, latest filing. Query: ?ticker= or ?cik=
- GET /v1/us/financials ($0.05): US public company key annual financials from SEC XBRL: revenue, net income, assets, liabilities, equity, cash (3 years). Query: ?ticker= or ?cik=
- GET /v1/us/filings ($0.02): Recent SEC filings for a US company (10-K, 10-Q, 8-K...) with dates and document URLs. Query: ?ticker= or ?cik= &type=
- GET /v1/us/snapshot ($0.06): One-call US company financial snapshot: revenue, growth, net income, margin, ROE, profitability from SEC XBRL. Query: ?ticker= or ?cik=
- GET /v1/maps ($0.03): Google Maps local business scraper via a FRENCH RESIDENTIAL IP (Google blocks datacenter IPs). One call = one activity+location search -> up to 120 businesses with name, rating, category, address, Maps URL. The first `detailsMax` results (default 25, max 60) are also enriched with phone, website and review count; beyond that these three fields are null. Query: ?q=<activity>&location=<city>&max=&detailsMax=&details=false (feed only, faster)
- GET /v1/fr/enrich ($0.08): Enrich a French company (Clearbit/Apollo for France): input a SIREN or a name (+city) -> full sales dossier = legal identity, directors, financials, INSOLVENCY risk (BODACC), plus CONTACT (phone, website, rating) found via residential Google Maps. Registry + legal announcements + Maps in one call. Query: ?siren= or ?name=&city=
- GET /v1/fr/leboncoin ($0.02): Leboncoin listings (France's #1 classifieds) via its internal JSON API + a residential IP that carries a solved DataDome session. Reaches what cloud scrapers cannot (Leboncoin is DataDome-protected). Search by keyword and/or category + city -> structured ads (title, price, city, date, url, images, attributes). Query: ?text=&category=&city=&zipcode=&limit=
- GET /v1/fr/seloger ($0.03): SeLoger real-estate listings (DataDome-protected, unreachable from datacenters). Search a city (buy/rent) -> listings with type, rooms, surface, price, price per m2, URL + median asking price/m2. Pairs with DVF sold prices. Query: ?city=&cp=&type=achat|location&max=
- GET /v1/unblock ($0.02): Unblock ANY anti-bot-protected URL (DataDome, Cloudflare, PerimeterX) and get clean content. Sell the capability, not the data: residential IP + challenge solving. Query: ?url= (&country=fr &render=true &format=html|text|markdown). Returns the page others can't fetch.
- GET /v1/fr/biens-sous-cotes ($0.05): Undervalued French property deal-flow: cross a commune's LISTED prices (Bien'ici) with the OFFICIAL SOLD-price median (DVF) -> properties listed well below what the area actually sells for. Sorted by discount. Query: ?city=&cp=&minGap=20. The asking-vs-sold gap nobody else assembles.
- GET /v1/fr/marches-publics ($0.02): Live French public tenders (BOAMP, official): find open procurement contracts to bid on by keyword + department, with buyer, object, publication & response deadline, days-left. The revenue-opportunity feed for BD/tender-watch agents — loop by keyword+department for continuous monitoring. Query: ?q=&departement=&actif=true&order=deadline|recent&max=
- GET /v1/fr/qualified-leads ($0.25): Qualified French B2B leads in one call: finds businesses by activity+city (Google Maps via residential IP -> phone, website, rating) then CROSS-REFERENCES each with the official company registry (SIREN, legal form, NAF, directors, age, status) and scores them HOT/WARM/COLD. A full call list + qualification a solo dev can't assemble (needs residential IP + registry + orchestration). Query: ?activity=&location=&max=
- GET /v1/amazon ($0.02): Amazon product & search scraper via a residential IP + stealth browser (bypasses Amazon bot detection). Product mode (?asin= or ?url=) -> title, price, rating, reviews, brand, image. Search mode (?q=) -> up to 60 products with price/rating. Great for price monitoring & competitive intel.
- GET /v1/fr/immo ($0.03): French real-estate listings (asking prices) from Bien'ici via a residential IP (datacenter IPs are blocked). One call = one city search -> listings with type, rooms, surface, price, €/m², postal code, URL + a median asking €/m². Pairs with /v1/fr/estimation-immo (DVF sold prices) to compare asking vs sold. Query: ?city=&cp=&type=achat|location
- GET /v1/search ($0.003): Cheap web search (real Google results via Serper): top 10 organic results + answer box + knowledge graph. Cheaper than Exa /search on x402. Query: ?q=&gl=&hl=
- GET /v1/search/news ($0.003): Fresh news search (Google News via Serper): latest headlines with source, date, snippet. Great for crypto/market/current-events agents. Query: ?q=&gl=&hl=
- POST /v1/llm ($0.002): Cheap LLM inference pay-per-call, no account, no API key: prompt in, completion out (DeepSeek v4, up to 2000 output tokens). Among the lowest $/call on x402. Body: {prompt, system?, max_tokens?}
- GET /v1/extract-structured ($0.015): URL + wanted fields -> clean JSON. Scrapes the page from a French residential IP (reaches sites that block datacenters) and uses an LLM to return exactly the fields you ask for. The 'scrape into this shape' call agents love (Firecrawl-extract territory), cheaper. Query: ?url=&fields=price,rating,stock (or ?schema=free-text)
- POST /v1/llm/pro ($0.006): Smart LLM inference (DeepSeek v4 Pro): stronger reasoning for hard prompts, up to 2000 output tokens, no account. Body: {prompt, system?, max_tokens?}

## Free previews
- POST /free/extract {url}: first 300 chars of the markdown extraction (full: POST /v1/extract)
- GET /free/entreprise?q=: first French company result, reduced fields (full: GET /v1/fr/entreprise)
- GET /free/entreprise-360?q=: company identity only (full 360 report: GET /v1/fr/entreprise-360)
- GET /free/estimation-immo?adresse=: commune median €/m² only (full AVM: GET /v1/fr/estimation-immo)

## How to pay
Any x402-compatible client works (@x402/fetch, x402-requests…). Call the endpoint, receive HTTP 402 with the PAYMENT-REQUIRED header, sign the USDC payment, retry. Median cost: $0.005-0.02 per call.