# Trusted Information API

Pay-per-call UK company, property and crypto market data for AI agents. No signup,
no API key: each endpoint returns HTTP 402 with payment instructions (x402 protocol
v2, scheme "exact", USDC on Base mainnet, eip155:8453). Pay per request via the PAYMENT header.

## Paid endpoints
- GET /api/crypto/context?pair=... — $0.005 — Calibrated crypto market context for one asset: price, 14-day range position, realized volatility regime, 1-sigma expected daily band, and trend context. Structured context for trading agents — not a buy/sell oracle.
- GET /api/uk-business/search?q=... — $0.005 — Search the UK Companies House register by company name or keyword. Returns matching companies with number, status, type, incorporation date and address.
- GET /api/uk-business/company?company=... — $0.01 — Full UK company profile by company number: status, SIC codes, registered office, accounts due dates, and computed risk flags (company age, accounts overdue, insolvency history).
- GET /api/uk-business/name-check?name=... — $0.01 — Check a proposed UK business name against the live Companies House register. Returns a verdict (likely_available / caution_similar_names_exist / likely_unavailable) with exact and close matches.
- GET /api/uk-business/dossier?company=... — $0.10 — One-hop UK company due-diligence dossier: profile, active officers, recent filings, charges, plus computed flags — company age, accounts lateness, confirmation-statement status, insolvency history, and 24-month director churn. Bundles what would otherwise be four register lookups.
- GET /api/uk-business/gazette?q=... — $0.01 — Search The Gazette's official insolvency notices by company name or number: liquidations, administrations, winding-up petitions and notices to creditors, with notice type, date and link to the official record.
- GET /api/uk-property/crime?postcode=... — $0.01 — Street-level crime context for a UK postcode: total crimes within a 1-mile radius for the latest published month, broken down by category, with ward and district. Official police open data (England, Wales, NI).
- GET /api/uk-property/energy?postcode=... — $0.02 — Domestic Energy Performance Certificates for a UK postcode: band distribution, share rated C or better, and the latest certificates with address, band and registration date. Official MHCLG register data.
- GET /api/uk-property/market-summary?area=... — $0.03 — One-call UK property investment context for an area: current average price, annual change, 3-month momentum, sales-volume trend, first-time-buyer price point, prices by property type, and a plain-language market read. Official statistics; not financial advice.
- GET /api/uk-property/price-trends?area=...&months=... — $0.02 — Official UK House Price Index series for any UK area (country, region, county or local authority): monthly average price, annual % change, monthly % change, and sales volumes, newest first. Sourced live from HM Land Registry.
- GET /api/uk-property/sold-prices?postcode=... — $0.02 — Actual sold-property transactions for a full UK postcode from HM Land Registry Price Paid Data: price, date, address, property type, new-build flag and tenure, plus min/median/max stats.

## Request data we don't offer yet (agents only, free)
If you need data not listed above, tell us so we can build it:
- POST /api/request-data  Content-Type: application/json  { "need": "<what data>", "example_use": "<why>", "contact": "<optional>" }

## Free endpoints
- GET /health — health check
- GET /llms.txt — this file
- GET /openapi.json — OpenAPI 3.1 spec with x402 payment metadata