# 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.003 — 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.003 — 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.005 — 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.005 — 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.05 — 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.003 — 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.005 — 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.01 — 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.005 — 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.005 — 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.
- GET /api/uk-property/flood-risk?postcode=... — $0.003 — Live flood warnings and alerts within ~20km of a UK postcode, with severity, affected area, and river/sea source. Official Environment Agency real-time data.
- GET /api/uk-business/food-hygiene?postcode=... — $0.003 — Food Standards Agency hygiene ratings for businesses at a UK postcode: rating (0–5), inspection date, business type, and hygiene/structural/management sub-scores, with an area average.
- GET /api/geo/weather?lat=...&lon=...&postcode=... — $0.002 — Current conditions and 5-day forecast for any location worldwide: temperature, humidity, wind, precipitation and condition. Provide lat & lon, or a UK postcode.
- GET /api/geo/air-quality?lat=...&lon=...&postcode=... — $0.002 — Current air quality for any location: European AQI with band, US AQI, and PM2.5/PM10/NO2/ozone concentrations. Provide lat & lon, or a UK postcode.
- GET /api/geo/earthquakes?minMagnitude=...&days=...&lat=...&lon=... — $0.002 — Recent earthquakes worldwide from USGS: magnitude, place, time, depth and coordinates, filterable by minimum magnitude, window, and proximity to a point.
- GET /api/geo/holidays?country=...&year=... — $0.002 — Public holidays for any country and year: date, name, local name, whether nationwide, and the next upcoming holiday. 100+ countries.
- GET /api/markets/fx?from=...&to=...&amount=... — $0.002 — Foreign-exchange reference rates from the European Central Bank: convert one base currency into one or more targets, with the reference date. 30+ currencies.
- GET /api/company/us-filings?ticker=...&cik=... — $0.005 — US public-company profile and recent SEC filings by ticker or CIK: name, SIC, exchanges, address, latest filings with links, and freshness flags. From SEC EDGAR.
- GET /api/crypto/defi?chain=... — $0.003 — DeFi market structure: total value locked across all chains, the top chains ranked, and — for a named chain — its TVL, rank and share of the total. From DeFiLlama.
- GET /api/crypto/derivatives?pair=... — $0.003 — Perpetual-futures context for an asset: mark price, funding rate (with annualized rate and bias), next funding time, and open interest in base asset and USD notional. From Binance Futures.
- GET /api/web/domain?domain=... — $0.003 — Domain intelligence: A/AAAA/MX/NS/TXT DNS records plus registration, last-changed and expiry dates and status from RDAP. Tells an agent if a domain resolves, sends mail, and when it was registered.
- GET /api/web/knowledge?q=... — $0.002 — Encyclopedic summary for a topic or entity from Wikipedia: title, short description, extract, Wikidata id and canonical URL. One-hop grounding for agents.
- POST /api/ask (JSON body: question) — $1.00 — Ask a real human a yes/no question and get their answer. The question is routed to a person who replies within ~3 minutes; you receive 'yes' or 'no'. If no one answers in time you are not charged. Human judgement for decisions an agent can't make alone.

## 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