{"openapi":"3.1.0","info":{"title":"Oromi Agent Services","version":"0.1.0","description":"Machine-payable APIs for AI agents, paid per call in USDC via the x402 protocol: UK business data (Companies House), UK property market data (HM Land Registry), website agent-readiness audits, and crypto market context.","contact":{"name":"Oromi","url":"https://oromi.co.uk","email":"ekisar@gmail.com"}},"servers":[{"url":"https://agents.oromi.co.uk"}],"paths":{"/api/uk-business/search":{"get":{"operationId":"get_api_uk_business_search","summary":"Search the UK Companies House register by company name or keyword","description":"Search the UK Companies House register by company name or keyword. Returns matching companies with number, status, type, incorporation date and address.","x-payment-info":{"price":"$0.005","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"query":"artisan bakery","total_results":42,"items":[{"company_name":"ARTISAN BAKERY LTD","company_number":"12345678","status":"active"}]}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"example":"artisan bakery"},{"name":"items","in":"query","required":false,"schema":{"type":"string"},"example":"10"}]}},"/api/uk-business/company":{"get":{"operationId":"get_api_uk_business_company","summary":"Full UK company profile by company number: status, SIC codes, registered office, accounts due dates, and current officers","description":"Full UK company profile by company number: status, SIC codes, registered office, accounts due dates, and current officers.","x-payment-info":{"price":"$0.01","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"company_name":"EXAMPLE LTD","status":"active","sic_codes":["62012"],"officers":[]}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"number","in":"query","required":false,"schema":{"type":"string"},"example":"00000006"}]}},"/api/uk-business/name-check":{"get":{"operationId":"get_api_uk_business_name_check","summary":"Check a proposed UK business name against the live Companies House register","description":"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.","x-payment-info":{"price":"$0.01","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"proposed_name":"Bluebird Roofing","verdict":"likely_available","exact_matches":[]}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"},"example":"Bluebird Roofing"}]}},"/api/uk-property/price-trends":{"get":{"operationId":"get_api_uk_property_price_trends","summary":"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","description":"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.","x-payment-info":{"price":"$0.02","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"area":"greater-manchester","latest":{"month":"2026-05","average_price":265000,"annual_change_pct":3.1},"series":[]}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"area","in":"query","required":false,"schema":{"type":"string"},"example":"greater-manchester"},{"name":"months","in":"query","required":false,"schema":{"type":"string"},"example":"24"}]}},"/api/uk-property/sold-prices":{"get":{"operationId":"get_api_uk_property_sold_prices","summary":"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","description":"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.","x-payment-info":{"price":"$0.02","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"postcode":"SW1A 1AA","stats":{"median":850000},"items":[{"price_gbp":850000,"date":"2026-03-14"}]}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"postcode","in":"query","required":false,"schema":{"type":"string"},"example":"SW1A 1AA"},{"name":"items","in":"query","required":false,"schema":{"type":"string"},"example":"30"}]}},"/api/uk-property/market-summary":{"get":{"operationId":"get_api_uk_property_market_summary","summary":"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","description":"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.","x-payment-info":{"price":"$0.03","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"area":"leeds","average_price_gbp":240000,"annual_change_pct":2.8,"sales_volume_trend":"flat","context":"prices_rising_modestly"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"area","in":"query","required":false,"schema":{"type":"string"},"example":"leeds"}]}},"/api/agent-ready/scan":{"post":{"operationId":"post_api_agent_ready_scan","summary":"Scan any business website URL and get structured, agent-usable data: contact channels, booking links, opening hours, schema","description":"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.","x-payment-info":{"price":"$0.05","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"url":"https://example-business.co.uk","business_name":"Example Salon","agent_readiness":{"score":65,"grade":"B"}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"requestBody":{"required":true,"content":{"application/json":{"example":{"url":"https://example-business.co.uk"}}}}}},"/api/uk-business/food-hygiene":{"get":{"operationId":"get_api_uk_business_food_hygiene","summary":"Official UK Food Hygiene Ratings (FSA) for restaurants, cafes and food businesses: rating 0-5, inspection date, address and local authority","description":"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.","x-payment-info":{"price":"$0.01","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"results":[{"business_name":"Dishoom","rating":"5","rating_date":"2025-11-02"}]}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"},"example":"Dishoom"},{"name":"address","in":"query","required":false,"schema":{"type":"string"},"example":"London"}]}},"/api/uk-property/area-crime":{"get":{"operationId":"get_api_uk_property_area_crime","summary":"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","description":"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.","x-payment-info":{"price":"$0.02","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"postcode":"LS1 4AP","total_street_crimes_1mi_radius":214,"top_category":"anti-social-behaviour","context":"moderate_reported_crime_area"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"postcode","in":"query","required":false,"schema":{"type":"string"},"example":"LS1 4AP"}]}},"/api/uk-property/mortgage-context":{"get":{"operationId":"get_api_uk_property_mortgage_context","summary":"Deterministic UK mortgage mathematics: monthly repayment, total interest, LTV, and a +3% rate stress test","description":"Deterministic UK mortgage mathematics: monthly repayment, total interest, LTV, and a +3% rate stress test. Exact computation agents cannot do reliably themselves.","x-payment-info":{"price":"$0.005","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"monthly_payment":1500.63,"ltv_pct":90,"stress_test_plus_3pct":{"monthly_payment":1966.5}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"price","in":"query","required":false,"schema":{"type":"string"},"example":"300000"},{"name":"deposit","in":"query","required":false,"schema":{"type":"string"},"example":"30000"},{"name":"rate","in":"query","required":false,"schema":{"type":"string"},"example":"4.5"},{"name":"years","in":"query","required":false,"schema":{"type":"string"},"example":"25"}]}},"/api/uk/official-rates":{"get":{"operationId":"get_api_uk_official_rates","summary":"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","description":"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=.","x-payment-info":{"price":"$0.005","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"section":"minimum_wage","data":{"national_living_wage_21_plus":12.71,"effective_from":"2026-04-01"}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"section","in":"query","required":false,"schema":{"type":"string"},"example":"minimum_wage"}]}},"/api/uk-property/epc":{"get":{"operationId":"get_api_uk_property_epc","summary":"Domestic Energy Performance Certificates (EPC) for England & Wales postcodes: efficiency bands, registration dates, addresses, and the postcode's band distribution","description":"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).","x-payment-info":{"price":"$0.02","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"postcode":"LS1 4AP","certificates":18,"rating_distribution":{"C":7,"D":8}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"postcode","in":"query","required":false,"schema":{"type":"string"},"example":"LS1 4AP"},{"name":"items","in":"query","required":false,"schema":{"type":"string"},"example":"25"}]}},"/api/uk-business/due-diligence":{"get":{"operationId":"get_api_uk_business_due_diligence","summary":"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","description":"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.","x-payment-info":{"price":"$0.10","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"assessment":{"overall":"no_red_flags_found","concerns":[]},"company":{"name":"TESCO PLC","status":"active"}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"number","in":"query","required":false,"schema":{"type":"string"},"example":"00445790"},{"name":"website","in":"query","required":false,"schema":{"type":"string"},"example":"https://www.tesco.com"}]}},"/api/web/pdf-extract":{"post":{"operationId":"post_api_web_pdf_extract","summary":"Fetch any PDF by URL and get its text: up to 100 pages, with title, author, page count and word count","description":"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.","x-payment-info":{"price":"$0.02","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"pages":12,"word_count":4820,"text":"..."}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"requestBody":{"required":true,"content":{"application/json":{"example":{"url":"https://example.com/report.pdf"}}}}}},"/api/web/url-status":{"get":{"operationId":"get_api_web_url_status","summary":"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","description":"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.","x-payment-info":{"price":"$0.001","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"ok":true,"status":200,"final_url":"https://example.com/article","redirected":false}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"url","in":"query","required":false,"schema":{"type":"string"},"example":"https://example.com/article"},{"name":"include_title","in":"query","required":false,"schema":{"type":"string"},"example":"1"}]}},"/api/util/validate-json":{"post":{"operationId":"post_api_util_validate_json","summary":"External referee for structured output: validate any JSON data against a JSON Schema and get precise, per-path error messages","description":"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.","x-payment-info":{"price":"$0.002","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"valid":false,"errors":[{"path":"/","keyword":"required","message":"must have required property 'name'"}]}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"requestBody":{"required":true,"content":{"application/json":{"example":{"schema":{"type":"object","required":["name"]},"data":{"name":"ok"}}}}}}},"/api/verify/email":{"get":{"operationId":"get_api_verify_email","summary":"Email deliverability verification without sending anything: syntax, live MX records, disposable-domain detection, role-account flag, and a verdict","description":"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.","x-payment-info":{"price":"$0.005","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"verdict":"deliverable_likely","checks":{"mx_present":true,"disposable_domain":false}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"address","in":"query","required":false,"schema":{"type":"string"},"example":"jane@example.co.uk"}]}},"/api/verify/domain":{"get":{"operationId":"get_api_verify_domain","summary":"Domain trust signals: registration age via RDAP, registrar, DNS resolution, HTTPS reachability, and a verdict (established / caution_very_new_domain / not_resolving)","description":"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.","x-payment-info":{"price":"$0.01","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"verdict":"established","signals":{"age_days":4300,"dns_resolves":true,"https_ok":true}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"},"example":"example.co.uk"}]}},"/api/verify/vat-eu":{"get":{"operationId":"get_api_verify_vat_eu","summary":"Validate an EU VAT number against the official VIES register","description":"Validate an EU VAT number against the official VIES register. Returns validity plus the registered business name and address where disclosed.","x-payment-info":{"price":"$0.01","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"valid":true,"registered_name":"GOOGLE IRELAND LIMITED"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string"},"example":"IE"},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"example":"6388047V"}]}},"/api/verify/iban":{"get":{"operationId":"get_api_verify_iban","summary":"Offline IBAN validation: country recognition, length check and MOD-97 checksum","description":"Offline IBAN validation: country recognition, length check and MOD-97 checksum. Catch payment-detail errors before initiating transfers.","x-payment-info":{"price":"$0.002","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"valid":true,"country":"GB","checks":{"checksum_ok":true}}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"iban","in":"query","required":false,"schema":{"type":"string"},"example":"GB29NWBK60161331926819"}]}},"/api/util/uk-working-days":{"get":{"operationId":"get_api_util_uk_working_days","summary":"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","description":"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.","x-payment-info":{"price":"$0.002","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"from":"2026-07-21","working_days_added":10,"result_date":"2026-08-04"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string"},"example":"2026-07-21"},{"name":"add","in":"query","required":false,"schema":{"type":"string"},"example":"10"}]}},"/api/util/fx":{"get":{"operationId":"get_api_util_fx","summary":"Live currency conversion using ECB reference rates","description":"Live currency conversion using ECB reference rates. Exact amounts agents should not guess.","x-payment-info":{"price":"$0.002","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"from":"GBP","to":"USD","amount":250,"converted":317.4,"rate_date":"2026-07-21"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string"},"example":"GBP"},{"name":"to","in":"query","required":false,"schema":{"type":"string"},"example":"USD"},{"name":"amount","in":"query","required":false,"schema":{"type":"string"},"example":"250"}]}},"/api/web/extract":{"post":{"operationId":"post_api_web_extract","summary":"Fetch any web page and return the readable content as clean text: boilerplate stripped, main content preferred, with title, description, language and word count","description":"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.","x-payment-info":{"price":"$0.01","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"title":"Example article","word_count":843,"text":"..."}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"requestBody":{"required":true,"content":{"application/json":{"example":{"url":"https://example.com/article"}}}}}},"/api/web/robots-check":{"get":{"operationId":"get_api_web_robots_check","summary":"Check whether a URL may be crawled by a given user-agent under the site's robots","description":"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.","x-payment-info":{"price":"$0.002","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"allowed":true,"matched_rule":null}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"url","in":"query","required":false,"schema":{"type":"string"},"example":"https://example.com/products/1"},{"name":"agent","in":"query","required":false,"schema":{"type":"string"},"example":"MyAgentBot"}]}},"/api/human/verify":{"post":{"operationId":"post_api_human_verify","summary":"A REAL HUMAN answers your yes/no question","description":"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).","x-payment-info":{"price":"$0.50","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"task_id":"ht_1a2b3c","status":"pending","poll_url":"https://agents.oromi.co.uk/api/human/result?task_id=ht_1a2b3c"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"requestBody":{"required":true,"content":{"application/json":{"example":{"question":"Does this website look like a legitimate business to you?","url":"https://example.co.uk"}}}}}},"/api/human/task":{"post":{"operationId":"post_api_human_task","summary":"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","description":"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.","x-payment-info":{"price":"$3.00","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"task_id":"ht_9x8y7z","status":"pending","poll_url":"https://agents.oromi.co.uk/api/human/result?task_id=ht_9x8y7z"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"requestBody":{"required":true,"content":{"application/json":{"example":{"task":"Visit this restaurant's website and tell me: could a customer figure out how to book a table for Saturday? What would confuse them?","url":"https://example-restaurant.co.uk"}}}}}},"/api/crypto/context":{"get":{"operationId":"get_api_crypto_context","summary":"Calibrated crypto market context for one asset: price, 14-day range position, realized volatility regime, 1-sigma expected daily band, and trend context","description":"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.","x-payment-info":{"price":"$0.005","scheme":"exact","network":"eip155:8453","currency":"USDC","payTo":"0x4083773C9255C2BE1b9Abfb574231a00E446779d"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"symbol":"BTC","price_usd":100000,"volatility":{"regime":"normal"},"trend_context":"neutral_context"}}}},"402":{"description":"Payment Required — x402 challenge with accepted payment methods"}},"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"example":"btc"}]}},"/llms.txt":{"get":{"operationId":"get_llms_txt","summary":"Agent-readable service catalog (free)","security":[],"responses":{"200":{"description":"Plain-text catalog of endpoints and prices"}}}},"/health":{"get":{"operationId":"get_health","summary":"Health check (free)","security":[],"responses":{"200":{"description":"Service status"}}}},"/api/human/result":{"get":{"operationId":"get_human_result","summary":"Poll a human-in-the-loop task result (free)","description":"Free polling for tasks created by /api/human/verify and /api/human/task. Query param: task_id.","security":[],"parameters":[{"name":"task_id","in":"query","required":true,"schema":{"type":"string"},"example":"ht_1a2b3c"}],"responses":{"200":{"description":"Task status; includes answer/note when answered"}}}},"/api/feedback":{"post":{"operationId":"post_feedback","summary":"Tell us what data or endpoint you wish existed (free)","description":"Free, no payment. A human reads every submission and requested endpoints genuinely get built. Body: {\"request\": \"what you need\", \"endpoint\": \"optional related endpoint\", \"contact\": \"optional\"}.","security":[],"requestBody":{"required":true,"content":{"application/json":{"example":{"request":"UK planning applications by postcode"}}}},"responses":{"200":{"description":"Feedback received"}}}}}}