# Oromi Agent Services

Machine-payable APIs for AI agents. Pay per call with USDC via the x402 protocol.
Network: eip155:8453 (mainnet). No accounts, no API keys — send payment with the request.

## Endpoints

- GET /api/uk-business/search — $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 — $0.01 — Full UK company profile by company number: status, SIC codes, registered office, accounts due dates, and current officers.
- GET /api/uk-business/name-check — $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. Useful when helping a user name a new business.
- GET /api/uk-property/price-trends — $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 — $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.
- GET /api/uk-property/market-summary — $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.
- POST /api/agent-ready/scan — $0.05 — Scan any business website URL and get structured, agent-usable data: contact channels, booking links, opening hours, schema.org data, social profiles, plus a 0-100 agent-readiness score with a per-check breakdown.
- GET /api/uk-business/food-hygiene — $0.01 — Official UK Food Hygiene Ratings (FSA) for restaurants, cafes and food businesses: rating 0-5, inspection date, address and local authority. Search by business name and/or town or postcode.
- GET /api/uk-property/area-crime — $0.02 — Street-level crime context for any UK postcode: total reported crimes in the latest published month (~1 mile radius), breakdown by category, top category, and a plain-language read. Property due-diligence companion to market-summary.
- GET /api/uk-property/mortgage-context — $0.005 — Deterministic UK mortgage mathematics: monthly repayment, total interest, LTV, and a +3% rate stress test. Exact computation agents cannot do reliably themselves.
- GET /api/uk/official-rates — $0.005 — Current UK statutory figures with official source URLs — the numbers language models most often get wrong: Bank of England Bank Rate (live), CPI inflation (live), minimum wage bands, income tax and National Insurance thresholds (2026/27), VAT thresholds, corporation tax, SDLT stamp duty bands, savings/dividend/CGT allowances. Filter with ?section=.
- GET /api/uk-property/epc — $0.02 — Domestic Energy Performance Certificates (EPC) for England & Wales postcodes: efficiency bands, registration dates, addresses, and the postcode's band distribution. Official GOV.UK register (Scotland/NI have separate registers and return zero results with an explanatory note).
- GET /api/uk-business/due-diligence — $0.10 — One-call UK company due-diligence pack: Companies House profile + current officers + website domain trust signals (RDAP age, DNS, HTTPS) + full website agent-readiness scan, with red-flag assessment (company status, overdue accounts, very new domain, non-resolving website) and an overall verdict. Replaces four calls and the merge logic.
- POST /api/web/pdf-extract — $0.02 — Fetch any PDF by URL and get its text: up to 100 pages, with title, author, page count and word count. Most agent models cannot read PDFs — this turns them into plain text one call.
- GET /api/web/url-status — $0.001 — Citation insurance: check any URL before you cite or act on it — resolves or not, HTTP status, final URL after redirects, content type and length, optional page title. Priced for bulk checking of every link an agent emits.
- POST /api/util/validate-json — $0.002 — External referee for structured output: validate any JSON data against a JSON Schema and get precise, per-path error messages. Data may be an object or a JSON string (parse errors reported). For agents that must emit valid structured output.
- GET /api/verify/email — $0.005 — Email deliverability verification without sending anything: syntax, live MX records, disposable-domain detection, role-account flag, and a verdict. Verify contact data before acting on it.
- GET /api/verify/domain — $0.01 — Domain trust signals: registration age via RDAP, registrar, DNS resolution, HTTPS reachability, and a verdict (established / caution_very_new_domain / not_resolving). Check a domain before trusting or transacting with it.
- GET /api/verify/vat-eu — $0.01 — Validate an EU VAT number against the official VIES register. Returns validity plus the registered business name and address where disclosed.
- GET /api/verify/iban — $0.002 — Offline IBAN validation: country recognition, length check and MOD-97 checksum. Catch payment-detail errors before initiating transfers.
- GET /api/util/uk-working-days — $0.002 — UK working-day mathematics against the official England & Wales bank-holiday calendar: count working days between two dates, or compute the date N working days ahead. For deadlines, SLAs and completion dates.
- GET /api/util/fx — $0.002 — Live currency conversion using ECB reference rates. Exact amounts agents should not guess.
- POST /api/web/extract — $0.01 — Fetch any web page and return the readable content as clean text: boilerplate stripped, main content preferred, with title, description, language and word count. One call instead of fetch-and-clean.
- GET /api/web/robots-check — $0.002 — Check whether a URL may be crawled by a given user-agent under the site's robots.txt (longest-match Allow/Disallow evaluation). Stay compliant before you fetch.
- POST /api/human/verify — $0.50 — A REAL HUMAN answers your yes/no question. Ask anything a person can judge or check: 'does this website look legitimate?', 'is this photo actually the product described?', 'does this text read as written by a native speaker?'. ASYNC: you get a task_id instantly; poll the free /api/human/result endpoint — answered typically within 2 hours (08:00-22:00 UK), 24h expiry with refund. Lawful, verifiable requests only (no CAPTCHA/bot-detection bypass, no impersonation).
- POST /api/human/task — $3.00 — A REAL HUMAN performs a small task or check and writes up the result: verify a detail by looking at sources, sanity-check a plan, review a page as a customer would, make a judgment call that needs human eyes. ASYNC: task_id instantly, poll the free /api/human/result endpoint — typically answered within 2 hours (08:00-22:00 UK), 24h expiry with refund. Lawful, verifiable requests only.
- GET /api/crypto/context — $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.

## MCP server
- Use every endpoint as MCP tools in Claude/Cursor/any MCP client: `npx -y oromi-agent-services-mcp`
- npm: https://www.npmjs.com/package/oromi-agent-services-mcp — payment automatic with BUYER_PRIVATE_KEY, quote mode without.

## Want data we don't offer yet?
- POST https://agents.oromi.co.uk/api/feedback with JSON {"request": "what you need"} — free, no payment.
- A human reads every submission. Requested endpoints genuinely get built.

## Notes
- All responses are JSON with a retrieved_at timestamp and source attribution.
- UK business data is sourced live from the Companies House public register.
- UK property data is sourced live from HM Land Registry open data (UKHPI + Price Paid Data).
- Crypto context is informational only — not investment advice.
- Operator: Oromi (https://oromi.co.uk). More: https://agents.oromi.co.uk/