{"openapi":"3.1.0","info":{"title":"Trusted Information API","version":"1.0.0","description":"Pay-per-call UK data and market context for AI agents: official company registers, property data and crypto market context. No signup, no API keys — pay per request in USDC via the x402 protocol.","x-guidance":"All endpoints are GET with query parameters and return JSON. Each paid endpoint responds 402 with x402 v2 payment instructions in the PAYMENT-REQUIRED header; pay per request in USDC (Base) — no account needed. UK company due diligence: /api/uk-business/search finds companies by name; /api/uk-business/company returns a profile with risk flags by company number; /api/uk-business/dossier bundles profile, officers, filings, charges and Gazette insolvency notices with computed flags (age, filing lateness, director churn) in one call; /api/uk-business/name-check tests a proposed company name; /api/uk-business/gazette searches official insolvency notices. UK property: /api/uk-property/market-summary gives one-call investment context for an area; /api/uk-property/price-trends returns the official House Price Index series; /api/uk-property/sold-prices lists real transactions for a postcode; /api/uk-property/energy returns EPC certificates for a postcode; /api/uk-property/crime gives street-level crime context. Crypto: /api/crypto/context returns calibrated market context (price, range position, volatility regime, 1-sigma band, trend) for one asset — context, not trading advice. Failed requests are never charged: payment settles only after the data handler succeeds.","contact":{"email":"norbertbn7@gmail.com"},"x-logo":{"url":"https://api.trustedinformation.site/logo.svg","altText":"Trusted Information"}},"servers":[{"url":"https://api.trustedinformation.site"}],"paths":{"/health":{"get":{"operationId":"health","summary":"Health check (free)","tags":["meta"],"security":[],"responses":{"200":{"description":"OK"}}}},"/api/crypto/context":{"get":{"operationId":"crypto-context","summary":"Calibrated crypto market context for one asset: price, 14-day range position, realized volatility regime, 1-sigma expect","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.","tags":["crypto"],"parameters":[{"name":"pair","in":"query","required":true,"description":"Asset pair, e.g. BTC-USD or ETH-USD","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"pair":{"type":"string"},"price":{"type":"number"},"asOf":{"type":"string"},"range14d":{"type":"object"},"realizedVol":{"type":"object"},"expectedDailyBand1Sigma":{"type":"object"},"trend":{"type":"object"},"source":{"type":"string"},"note":{"type":"string"}},"required":["pair","price","range14d","realizedVol","trend"]},"example":{"pair":"BTC-USD","price":66371.29,"asOf":"2026-07-23T21:00:00Z","range14d":{"high":65799,"low":61544.56,"position":1.14},"realizedVol":{"daily":0.0162,"annualized":0.31,"regime":"normal","percentile90d":0.54},"expectedDailyBand1Sigma":{"lower":65295.22,"upper":67447.36},"trend":{"state":"uptrend","sma20":63517.85,"priceVsSma20Pct":4.49},"source":"binance"}}}},"402":{"description":"Payment Required"}}}},"/api/uk-business/search":{"get":{"operationId":"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.","tags":["uk-business"],"parameters":[{"name":"q","in":"query","required":true,"description":"Company name or keyword","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"companyNumber":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"incorporated":{"type":"string"}}}}},"required":["query","count","results"]},"example":{"query":"tesco","count":20,"results":[{"companyNumber":"00445790","name":"TESCO PLC","status":"active","type":"plc","incorporated":"1947-11-27","address":"Welwyn Garden City, AL7 1GA"}],"source":"Companies House"}}}},"402":{"description":"Payment Required"}}}},"/api/uk-business/company":{"get":{"operationId":"uk-business-company","summary":"Full UK company profile by company number: status, SIC codes, registered office, accounts due dates, and computed risk f","description":"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).","tags":["uk-business"],"parameters":[{"name":"company","in":"query","required":true,"description":"Companies House company number","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"companyNumber":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"incorporated":{"type":"string"},"sicCodes":{"type":"array"},"registeredOffice":{"type":"object"},"accounts":{"type":"object"},"flags":{"type":"object"}},"required":["companyNumber","name","status","flags"]},"example":{"companyNumber":"00445790","name":"TESCO PLC","status":"active","type":"plc","incorporated":"1947-11-27","sicCodes":["47110"],"accounts":{"nextDue":"2026-08-26","overdue":false},"flags":{"companyAgeYears":78.7,"accountsOverdue":false,"confirmationStatementOverdue":false,"hasCharges":false,"hasInsolvencyHistory":false,"statusRisk":false}}}}},"402":{"description":"Payment Required"}}}},"/api/uk-business/name-check":{"get":{"operationId":"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.","tags":["uk-business"],"parameters":[{"name":"name","in":"query","required":true,"description":"Proposed company name","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"proposedName":{"type":"string"},"verdict":{"type":"string","enum":["likely_available","caution_similar_names_exist","likely_unavailable"]},"exactMatches":{"type":"array"},"closeMatches":{"type":"array"}},"required":["proposedName","verdict"]},"example":{"proposedName":"Trusted Information Ltd","verdict":"caution_similar_names_exist","exactMatches":[],"closeMatches":[{"name":"TRUSTED INFORMATION SERVICES LIMITED","companyNumber":"04231166","status":"dissolved","similarity":0.87}]}}}},"402":{"description":"Payment Required"}}}},"/api/uk-business/dossier":{"get":{"operationId":"uk-business-dossier","summary":"One-hop UK company due-diligence dossier: profile, active officers, recent filings, charges, plus computed flags — compa","description":"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.","tags":["uk-business"],"parameters":[{"name":"company","in":"query","required":true,"description":"Companies House company number","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"companyNumber":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"flags":{"type":"object"},"officers":{"type":"array"},"recentFilings":{"type":"array"},"charges":{"type":["object","null"]},"gazetteInsolvencyNotices":{"type":["object","null"]}},"required":["companyNumber","name","status","flags","officers"]},"example":{"companyNumber":"00445790","name":"TESCO PLC","status":"active","incorporated":"1947-11-27","flags":{"companyAgeYears":78.7,"accountsOverdue":false,"hasInsolvencyHistory":false,"officerChurn24m":0.36,"activeOfficers":11,"resignedOfficersLast24m":4},"officers":[{"name":"BETHELL, Melissa","role":"director","appointed":"2018-09-24"}],"recentFilings":[{"date":"2026-06-30","category":"accounts","description":"Group of companies' accounts"}],"charges":null,"gazetteInsolvencyNotices":{"total":0,"latest":[]}}}}},"402":{"description":"Payment Required"}}}},"/api/uk-business/gazette":{"get":{"operationId":"uk-business-gazette","summary":"Search The Gazette's official insolvency notices by company name or number: liquidations, administrations, winding-up pe","description":"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.","tags":["uk-business"],"parameters":[{"name":"q","in":"query","required":true,"description":"Company name or number","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"totalNotices":{"type":"number"},"hasInsolvencyNotices":{"type":"boolean"},"notices":{"type":"array","items":{"type":"object","properties":{"company":{"type":"string"},"type":{"type":"string"},"published":{"type":"string"},"link":{"type":"string"}}}}},"required":["query","totalNotices","hasInsolvencyNotices","notices"]},"example":{"query":"carillion","totalNotices":196,"hasInsolvencyNotices":true,"notices":[{"company":"CARILLION PLC","type":"Resolutions for Winding-up","noticeCode":"2431","published":"2018-03-10T00:00:00","link":"https://www.thegazette.co.uk/id/notice/L-58635-471825"}]}}}},"402":{"description":"Payment Required"}}}},"/api/uk-property/crime":{"get":{"operationId":"uk-property-crime","summary":"Street-level crime context for a UK postcode: total crimes within a 1-mile radius for the latest published month, broken","description":"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).","tags":["uk-property"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"Full UK postcode","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"postcode":{"type":"string"},"area":{"type":"object"},"month":{"type":"string"},"totalCrimesWithin1Mile":{"type":"number"},"byCategory":{"type":"object"}},"required":["postcode","totalCrimesWithin1Mile","byCategory"]},"example":{"postcode":"PL6 8RU","area":{"ward":"Moor View","district":"Plymouth"},"month":"2026-05","totalCrimesWithin1Mile":49,"byCategory":{"violent-crime":23,"criminal-damage-arson":11,"burglary":3}}}}},"402":{"description":"Payment Required"}}}},"/api/uk-property/energy":{"get":{"operationId":"uk-property-energy","summary":"Domestic Energy Performance Certificates for a UK postcode: band distribution, share rated C or better, and the latest c","description":"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.","tags":["uk-property"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"Full UK postcode","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"postcode":{"type":"string"},"count":{"type":"number"},"bandDistribution":{"type":"object"},"shareBandCOrBetter":{"type":"number"},"certificates":{"type":"array"},"council":{"type":["string","null"]}},"required":["postcode","count","bandDistribution","certificates"]},"example":{"postcode":"E1 6AN","count":2,"bandDistribution":{"D":2},"shareBandCOrBetter":0,"certificates":[{"address":"6, Brushfield Street, LONDON","band":"D","registered":"2019-04-24","certificateNumber":"0352-2837-6649-9921-7631"}],"council":"City of London"}}}},"402":{"description":"Payment Required"}}}},"/api/uk-property/market-summary":{"get":{"operationId":"uk-property-market-summary","summary":"One-call UK property investment context for an area: current average price, annual change, 3-month momentum, sales-volum","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.","tags":["uk-property"],"parameters":[{"name":"area","in":"query","required":true,"description":"UK HPI area, e.g. england, wales, greater-manchester","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"area":{"type":"string"},"latestMonth":{"type":"string"},"averagePrice":{"type":["number","null"]},"annualChangePct":{"type":["number","null"]},"momentum3mPct":{"type":["number","null"]},"salesVolumeTrend":{"type":["string","null"]},"firstTimeBuyerPrice":{"type":["number","null"]},"byPropertyType":{"type":["object","null"]},"marketRead":{"type":"string"}},"required":["area","latestMonth","averagePrice","marketRead"]},"example":{"area":"England","latestMonth":"2026-04","averagePrice":291445,"annualChangePct":3.9,"momentum3mPct":0.79,"salesVolumeTrend":"falling","firstTimeBuyerPrice":244420,"byPropertyType":{"detached":472022,"semiDetached":289106,"terraced":244026,"flatMaisonette":218451},"marketRead":"England: average price £291,445; up 3.9% year-on-year; 3-month momentum +0.79%"}}}},"402":{"description":"Payment Required"}}}},"/api/uk-property/price-trends":{"get":{"operationId":"uk-property-price-trends","summary":"Official UK House Price Index series for any UK area (country, region, county or local authority): monthly average price","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.","tags":["uk-property"],"parameters":[{"name":"area","in":"query","required":true,"description":"UK HPI area slug, e.g. england or glasgow-city","schema":{"type":"string"}},{"name":"months","in":"query","required":false,"description":"How many months of history (1-120, default 24)","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"area":{"type":"string"},"count":{"type":"number"},"months":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string"},"averagePrice":{"type":["number","null"]},"annualChangePct":{"type":["number","null"]},"salesVolume":{"type":["number","null"]}}}}},"required":["area","count","months"]},"example":{"area":"England","count":24,"months":[{"month":"2026-04","averagePrice":291445,"annualChangePct":3.9,"monthlyChangePct":0.56,"salesVolume":null}]}}}},"402":{"description":"Payment Required"}}}},"/api/uk-property/sold-prices":{"get":{"operationId":"uk-property-sold-prices","summary":"Actual sold-property transactions for a full UK postcode from HM Land Registry Price Paid Data: price, date, address, pr","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.","tags":["uk-property"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"Full UK postcode","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"postcode":{"type":"string"},"count":{"type":"number"},"stats":{"type":"object"},"from":{"type":["string","null"]},"to":{"type":["string","null"]},"transactions":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"price":{"type":"number"},"address":{"type":"string"},"propertyType":{"type":["string","null"]}}}}},"required":["postcode","count","stats","transactions"]},"example":{"postcode":"PL6 8RU","count":45,"stats":{"min":56000,"median":192500,"max":350000},"from":"1999-11-08","to":"2025-06-30","transactions":[{"date":"2025-06-30","price":217750,"address":"104, PATTINSON DRIVE, PLYMOUTH","propertyType":"semi-detached","newBuild":false,"tenure":"Freehold"}]}}}},"402":{"description":"Payment Required"}}}}}}