{"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"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"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"}},"parameters":[{"name":"pair","in":"query","required":true,"description":"Asset pair, e.g. BTC-USD or ETH-USD","schema":{"type":"string"}}]}},"/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"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"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"}},"parameters":[{"name":"q","in":"query","required":true,"description":"Company name or keyword","schema":{"type":"string"}}]}},"/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"],"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":{"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"}},"parameters":[{"name":"company","in":"query","required":true,"description":"Companies House company number","schema":{"type":"string"}}]}},"/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"],"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":{"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"}},"parameters":[{"name":"name","in":"query","required":true,"description":"Proposed company name","schema":{"type":"string"}}]}},"/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"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"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"}},"parameters":[{"name":"company","in":"query","required":true,"description":"Companies House company number","schema":{"type":"string"}}]}},"/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"],"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"}},"parameters":[{"name":"q","in":"query","required":true,"description":"Company name or number","schema":{"type":"string"}}]}},"/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"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"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"}},"parameters":[{"name":"postcode","in":"query","required":true,"description":"Full UK postcode","schema":{"type":"string"}}]}},"/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"],"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":{"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"}},"parameters":[{"name":"postcode","in":"query","required":true,"description":"Full UK postcode","schema":{"type":"string"}}]}},"/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"],"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":{"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"}},"parameters":[{"name":"area","in":"query","required":true,"description":"UK HPI area, e.g. england, wales, greater-manchester","schema":{"type":"string"}}]}},"/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"],"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":{"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"}},"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"}}]}},"/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"],"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":{"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"}},"parameters":[{"name":"postcode","in":"query","required":true,"description":"Full UK postcode","schema":{"type":"string"}}]}},"/api/uk-property/flood-risk":{"get":{"operationId":"uk-property-flood-risk","summary":"Live flood warnings and alerts within ~20km of a UK postcode, with severity, affected area, and river/sea source","description":"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.","tags":["uk-property"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"postcode":{"type":"string"},"area":{"type":"object"},"hasActiveWarnings":{"type":"boolean"},"highestSeverity":{"type":"string"},"warningCount":{"type":"number"},"warnings":{"type":"array"}},"required":["postcode","hasActiveWarnings","warningCount"]},"example":{"postcode":"TA6 3JA","area":{"district":"Sedgemoor","region":"South West"},"hasActiveWarnings":false,"highestSeverity":"no active warnings","warningCount":0,"warnings":[],"source":"Environment Agency flood-monitoring"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"postcode","in":"query","required":true,"description":"Full UK postcode","schema":{"type":"string"}}]}},"/api/uk-business/food-hygiene":{"get":{"operationId":"uk-business-food-hygiene","summary":"Food Standards Agency hygiene ratings for businesses at a UK postcode: rating (0–5), inspection date, business type, and","description":"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.","tags":["uk-business"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"searchedPostcode":{"type":"string"},"searchScope":{"type":"string"},"count":{"type":"number"},"averageRating":{"type":["number","null"]},"below3Count":{"type":"number"},"establishments":{"type":"array"}},"required":["searchedPostcode","count","establishments"]},"example":{"searchedPostcode":"PL1 1AA","searchScope":"area PL1","count":32,"averageRating":4.5,"below3Count":2,"establishments":[{"name":"5.5 Desserts","type":"Mobile caterer","rating":"5","ratingDate":"2025-03-07","postcode":"PL1","localAuthority":"Plymouth City","scores":{"Hygiene":5,"Structural":5,"ConfidenceInManagement":5}}],"source":"Food Standards Agency"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"postcode","in":"query","required":true,"description":"UK postcode","schema":{"type":"string"}}]}},"/api/geo/weather":{"get":{"operationId":"geo-weather","summary":"Current conditions and 5-day forecast for any location worldwide: temperature, humidity, wind, precipitation and conditi","description":"Current conditions and 5-day forecast for any location worldwide: temperature, humidity, wind, precipitation and condition. Provide lat & lon, or a UK postcode.","tags":["geo"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"current":{"type":"object"},"forecast":{"type":"array"}},"required":["location","current","forecast"]},"example":{"location":"51.5,-0.12","current":{"temperatureC":29.1,"humidityPct":27,"windSpeedKmh":13.3,"condition":"partly cloudy"},"forecast":[{"date":"2026-07-25","maxC":30.2,"minC":17.8,"precipitationMm":0,"condition":"partly cloudy"}],"source":"Open-Meteo"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude","schema":{"type":"string"}},{"name":"lon","in":"query","required":false,"description":"Longitude","schema":{"type":"string"}},{"name":"postcode","in":"query","required":false,"description":"UK postcode (alternative to lat/lon)","schema":{"type":"string"}}]}},"/api/geo/air-quality":{"get":{"operationId":"geo-air-quality","summary":"Current air quality for any location: European AQI with band, US AQI, and PM2.5/PM10/NO2/ozone concentrations","description":"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.","tags":["geo"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"europeanAqi":{"type":["number","null"]},"band":{"type":["string","null"]},"pollutants":{"type":"object"}},"required":["location","pollutants"]},"example":{"location":"51.5,-0.12","europeanAqi":38,"band":"fair","usAqi":35,"pollutants":{"pm2_5":5.3,"pm10":8.1,"no2":12.4,"ozone":60.2},"source":"Open-Meteo air quality (CAMS)"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude","schema":{"type":"string"}},{"name":"lon","in":"query","required":false,"description":"Longitude","schema":{"type":"string"}},{"name":"postcode","in":"query","required":false,"description":"UK postcode (alternative to lat/lon)","schema":{"type":"string"}}]}},"/api/geo/earthquakes":{"get":{"operationId":"geo-earthquakes","summary":"Recent earthquakes worldwide from USGS: magnitude, place, time, depth and coordinates, filterable by minimum magnitude, ","description":"Recent earthquakes worldwide from USGS: magnitude, place, time, depth and coordinates, filterable by minimum magnitude, window, and proximity to a point.","tags":["geo"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"object"},"count":{"type":"number"},"largest":{"type":["number","null"]},"events":{"type":"array"}},"required":["count","events"]},"example":{"window":{"fromDate":"2026-07-18","minMagnitude":4.5},"count":42,"largest":6.1,"events":[{"magnitude":5,"place":"57 km S of Sarangani, Philippines","time":"2026-07-24T18:46:06Z","depthKm":52.2,"coordinates":{"lon":125.48,"lat":4.88},"url":"https://earthquake.usgs.gov/earthquakes/eventpage/us..."}],"source":"USGS Earthquake Hazards Program"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"minMagnitude","in":"query","required":false,"description":"Minimum magnitude (default 4.5)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Look-back window in days (1–30, default 7)","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Optional latitude to search near","schema":{"type":"string"}},{"name":"lon","in":"query","required":false,"description":"Optional longitude to search near","schema":{"type":"string"}}]}},"/api/geo/holidays":{"get":{"operationId":"geo-holidays","summary":"Public holidays for any country and year: date, name, local name, whether nationwide, and the next upcoming holiday","description":"Public holidays for any country and year: date, name, local name, whether nationwide, and the next upcoming holiday. 100+ countries.","tags":["geo"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"year":{"type":"number"},"count":{"type":"number"},"next":{"type":["object","null"]},"holidays":{"type":"array"}},"required":["country","year","holidays"]},"example":{"country":"GB","year":2026,"count":14,"next":{"date":"2026-08-31","name":"Summer Bank Holiday"},"holidays":[{"date":"2026-01-01","name":"New Year's Day","localName":"New Year's Day","nationwide":false,"regions":["GB-ENG","GB-SCT","GB-WLS","GB-NIR"]}],"source":"Nager.Date public holidays"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"country","in":"query","required":true,"description":"ISO 2-letter country code, e.g. GB, US, DE","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Year (default current)","schema":{"type":"string"}}]}},"/api/markets/fx":{"get":{"operationId":"markets-fx","summary":"Foreign-exchange reference rates from the European Central Bank: convert one base currency into one or more targets, wit","description":"Foreign-exchange reference rates from the European Central Bank: convert one base currency into one or more targets, with the reference date. 30+ currencies.","tags":["markets"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string"},"amount":{"type":"number"},"asOf":{"type":"string"},"rates":{"type":"object"},"converted":{"type":"object"}},"required":["base","asOf","rates"]},"example":{"base":"GBP","amount":1,"asOf":"2026-07-24","rates":{"EUR":1.1711,"USD":1.3324},"converted":{"EUR":1.1711,"USD":1.3324},"source":"European Central Bank (Frankfurter)"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"from","in":"query","required":false,"description":"Base currency (ISO code), e.g. GBP","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"Comma-separated target currencies, e.g. USD,EUR","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"Optional amount to convert (default 1)","schema":{"type":"string"}}]}},"/api/company/us-filings":{"get":{"operationId":"company-us-filings","summary":"US public-company profile and recent SEC filings by ticker or CIK: name, SIC, exchanges, address, latest filings with li","description":"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.","tags":["company"],"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":{"cik":{"type":"number"},"name":{"type":["string","null"]},"sic":{"type":["string","null"]},"tickers":{"type":"array"},"flags":{"type":"object"},"recentFilings":{"type":"array"}},"required":["cik","recentFilings"]},"example":{"cik":320193,"name":"Apple Inc.","sic":"Electronic Computers","tickers":["AAPL"],"exchanges":["Nasdaq"],"fiscalYearEnd":"0928","flags":{"lastFilingDate":"2026-06-17","daysSinceLastFiling":38,"recentFilingCount":1000},"recentFilings":[{"form":"4","filedOn":"2026-06-17","url":"https://www.sec.gov/Archives/edgar/data/320193/..."}],"source":"SEC EDGAR"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"ticker","in":"query","required":false,"description":"US stock ticker, e.g. AAPL","schema":{"type":"string"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK number (alternative to ticker)","schema":{"type":"string"}}]}},"/api/crypto/defi":{"get":{"operationId":"crypto-defi","summary":"DeFi market structure: total value locked across all chains, the top chains ranked, and — for a named chain — its TVL, r","description":"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.","tags":["crypto"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalDefiTvlUsd":{"type":"number"},"chainCount":{"type":"number"},"chain":{"type":["object","null"]},"topChains":{"type":"array"}},"required":["totalDefiTvlUsd","topChains"]},"example":{"totalDefiTvlUsd":98420000000,"chainCount":461,"chain":{"name":"Base","tvlUsd":4546917356,"rank":6,"shareOfTotalPct":4.62},"topChains":[{"rank":1,"name":"Ethereum","tvlUsd":60100000000}],"source":"DeFiLlama"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"chain","in":"query","required":false,"description":"Optional chain name, e.g. Base, Ethereum, Solana","schema":{"type":"string"}}]}},"/api/crypto/derivatives":{"get":{"operationId":"crypto-derivatives","summary":"Perpetual-futures context for an asset: mark price, funding rate (with annualized rate and bias), next funding time, and","description":"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.","tags":["crypto"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"pair":{"type":"string"},"markPrice":{"type":"number"},"fundingRate":{"type":"object"},"openInterest":{"type":"object"}},"required":["pair","markPrice","fundingRate"]},"example":{"pair":"BTC-USDT-PERP","markPrice":64160.57,"fundingRate":{"current":0.000016,"annualizedPct":1.72,"nextFundingTime":"2026-07-25T16:00:00Z","bias":"longs pay shorts"},"openInterest":{"baseAsset":75234.5,"notionalUsd":4826000000},"source":"Binance Futures"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"pair","in":"query","required":true,"description":"Asset pair, e.g. BTC-USD or ETH-USD","schema":{"type":"string"}}]}},"/api/web/domain":{"get":{"operationId":"web-domain","summary":"Domain intelligence: A/AAAA/MX/NS/TXT DNS records plus registration, last-changed and expiry dates and status from RDAP","description":"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.","tags":["web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"dns":{"type":"object"},"registration":{"type":"object"},"resolves":{"type":"boolean"},"hasMail":{"type":"boolean"}},"required":["domain","dns","resolves"]},"example":{"domain":"example.com","dns":{"a":["93.184.216.34"],"aaaa":[],"mx":[],"ns":["a.iana-servers.net","b.iana-servers.net"],"txt":["v=spf1 -all"]},"registration":{"registered":"1995-08-14T04:00:00Z","lastChanged":"2025-08-14T07:01:44Z","expires":"2026-08-13T04:00:00Z","status":["client delete prohibited"]},"resolves":true,"hasMail":false,"source":"Google Public DNS + RDAP"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"domain","in":"query","required":true,"description":"Domain name, e.g. example.com","schema":{"type":"string"}}]}},"/api/web/knowledge":{"get":{"operationId":"web-knowledge","summary":"Encyclopedic summary for a topic or entity from Wikipedia: title, short description, extract, Wikidata id and canonical ","description":"Encyclopedic summary for a topic or entity from Wikipedia: title, short description, extract, Wikidata id and canonical URL. One-hop grounding for agents.","tags":["web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"extract":{"type":["string","null"]},"wikidataId":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["query","title"]},"example":{"query":"Tesco","title":"Tesco","description":"British multinational retail groceries company","extract":"Tesco plc is a British multinational groceries and general merchandise retailer headquartered in the UK.","wikidataId":"Q487494","url":"https://en.wikipedia.org/wiki/Tesco","thumbnail":"https://upload.wikimedia.org/...","source":"Wikipedia"}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"q","in":"query","required":true,"description":"Topic or entity name","schema":{"type":"string"}}]}},"/api/ask":{"post":{"operationId":"ask","summary":"Ask a real human a yes/no question and get their answer","description":"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.","tags":["ask"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string","description":"A yes/no question for a human (max 500 chars)"}},"required":["question"]}}}}}}}}