# ISHOB | Intelligent Service Hub for Autonomous Bots

> The On-Chain Micro-Utility Gateway for Autonomous Agents.

ISHOB is an x402-enabled utility gateway for autonomous agents: scheduled callbacks (agent alarms), token and wallet security checks, weather and location risk, document rendering, web extraction, company data and an open-licence research archive. Pay per call in USDC on Base; no account or API key.

## Core utilities
- Agent alarm / callback scheduler: `POST https://api.ishob.com/v1/alarm`
- Token safety report: `POST https://api.ishob.com/v1/crypto/token-report`
- Wallet risk report: `GET https://api.ishob.com/v1/crypto/wallet-report`
- Transaction simulator: `POST https://api.ishob.com/v1/crypto/simulate-tx`
- Weather risk (drone-safe, outdoor events): `GET https://api.ishob.com/v1/weather`
- Location risk report: `GET https://api.ishob.com/v1/location-report`
- Document renderer (Markdown to PDF / DOCX / HTML): `POST https://api.ishob.com/v1/render-doc`
- Web page to Markdown: `POST https://api.ishob.com/v1/extract`
- Company snapshot (SEC data): `GET https://api.ishob.com/v1/company-snapshot`
- Research brief: `POST https://api.ishob.com/v1/research-brief`
- Payments: x402 micropayments, USDC on Base; prices per call are listed below.

ISHOB is built for AI agents: free discovery, pay-per-call content via the x402 HTTP payment protocol (Base, USDC). No account, no API key, no subscription. Missing resources return 404 before any payment is requested; failed deliveries are never charged.

## MCP server (recommended for agents)
- Endpoint: https://api.ishob.com/mcp (Streamable HTTP, stateless, JSON responses)
- Server card with tool input schemas and prices: https://api.ishob.com/.well-known/mcp.json
- Paid tools return an x402 payment requirement in the tool result; an x402-capable MCP client (e.g. @x402/mcp) signs and retries automatically, payment travels in `_meta["x402/payment"]`, the receipt in `_meta["x402/payment-response"]`.

### Tools
- `search_archive` (free): Search the ISHOB archive (titles, keywords, authors). All words must match.
- `list_topics` (free): List knowledge topics with live resource counts.
- `get_catalog_page` (free): Browse the catalog, 100 resources per page, optionally by topic.
- `get_document` ($0.001 USDC per call): Record metadata, abstract, license and attribution for one resource.
- `get_fulltext` ($0.01 USDC per call): Structured full text (sections) of one resource, with license.
- `get_references` ($0.002 USDC per call): Parsed reference list of one resource.
- `extract_webpage` ($0.001 USDC per call): Fetch a public web page live (robots.txt respected) and return clean Markdown. Not stored or redistributed.
- `site_metadata` ($0.0002 USDC per call): Extract a page's title, meta tags, OpenGraph, Twitter card, canonical/icons/feeds and JSON-LD from the <head> only (no full DOM download, robots.txt respected, nothing stored).
- `get_dataset` ($0.0001 USDC per call): Static Knowledge Base: open, commercially reusable datasets (world cities, countries, ISHOB topics) by page, by id or by facet filter, with licence and attribution. Free catalogue: /v1/datasets.
- `weather_risk` ($0.001 USDC per call): Current weather and hourly forecast (MET Norway, CC BY 4.0) for a lat/lon, plus decision flags: drone_safe, event_risk (low/moderate/high), rain_expected, frost_risk, high_wind — with the thresholds used. Heuristics, not aviation or safety advice.
- `domain_intel` ($0.0004 USDC per call): Domain intelligence: registration via RDAP (registrar, created/expiry dates, status, nameservers, DNSSEC; unregistered = likely available), DNS (A/AAAA/NS/MX/SPF/DMARC, email and DNS providers) and the homepage tech stack (CDN, hosting, server, CMS, frameworks, analytics, payments) with evidence.
- `geocode` ($0.001 USDC per call): Offline geocoding (GeoNames + DB-IP, CC BY 4.0): exactly one of ip (IPv4/IPv6 -> country/region/city/lat,lon), q (place name, e.g. 'Springfield, IL, US', optional country filter), postcode (+country), or lat+lon (reverse: nearest places). City/place level; no street addresses.
- `extract_tables` ($0.001 USDC per call): Extract tables as structured JSON (rows, header, records keyed by column) from a public PDF (multi-column / ruled tables, up to 30 pages, 10 MB) or an HTML page (colspan/rowspan expanded). robots.txt respected; nothing stored. No OCR.
- `finance_snapshot` ($0.001 USDC per call): Fundamentals and ratios for a US-listed company from its latest annual SEC filing (10-K/20-F, public domain): revenue, net income, EPS, cash flow, debt, equity; debt-to-equity, current/quick ratio, margins, ROE/ROA, growth. P/E and market cap are null (no licensed price feed); EPS and shares outstanding are included to compute them.
- `screenshot` ($0.001 USDC per call): Render a public web page in headless Chromium (Cloudflare Browser Rendering) and return a screenshot (PNG/JPEG/WebP, base64) for vision models: viewport up to 1920x1920 (default 1920x1080) or full page up to 8000 px. robots.txt respected; every page request is SSRF-guarded; nothing stored.
- `ping_status` ($0.0002 USDC per call): Uptime / API health check: is a URL up, HTTP status, response time, redirect chain, headers and security headers (edge), plus the TLS certificate (issuer, expiry date, days remaining, SAN, verification errors). A down target is a valid answer.
- `read_feed` ($0.0003 USDC per call): Read a published RSS 2.0 / RSS 1.0 / Atom / JSON Feed (blogs, news, podcasts, Reddit, Mastodon, YouTube channel feeds) as clean JSON items: title, link, ISO dates, author, plain-text summary/content, categories, enclosures. An HTML page URL is followed to its advertised feed. robots.txt respected; nothing stored; social networks are not scraped.
- `embed_text` ($0.0002 USDC per call): Text embeddings for RAG / semantic search: one string or up to 100 strings -> L2-normalised vectors with open BAAI models on Cloudflare GPUs: bge-small-en-v1.5 (384-d, English, default) or bge-m3 (1024-d, multilingual). Up to 24,000 characters per call.
- `site_speed` ($0.001 USDC per call): Page speed & Core Web Vitals from a real headless-Chromium load (mobile or desktop): LCP, CLS, FCP, TTFB, total blocking time with good/needs-improvement/poor ratings, load timings, request count and page weight by resource type. Unthrottled lab run from Cloudflare's network (not Lighthouse, not field data). robots.txt respected.
- `render_document` ($0.001 USDC per call): Render Markdown (tables, code, lists, headings) into a styled PDF (custom CSS, A4/Letter/Legal, page numbers), a Word DOCX or standalone HTML; returns a private download link valid for 24 hours. External resources are never fetched (inline data: images only).
- `contract_abi` ($0.001 USDC per call): Verified smart-contract ABI (+ optional Solidity/Vyper source) for Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain from the open Sourcify registry: compiler, deployment, read/write function and event signatures, and proxy resolution to the implementation ABI. Unverified contracts return 404 (not charged).
- `token_audit` ($0.001 USDC per call): Token safety & scam check for an ERC-20 (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain) or SPL mint (Solana): honeypot simulation, buy/sell tax, mint / blacklist / pause / owner privileges, LP lock, holder concentration (Powered by GoPlus Security) plus our own on-chain checks (proxy slots, owner, verified source, mint/freeze authority, Token-2022 extensions). Returns severity-ranked flags and a risk level.
- `swap_route` ($0.001 USDC per call): Best DEX swap route and quote on Ethereum, Base, Arbitrum, Optimism, Polygon or BNB Chain via the KyberSwap aggregator (400+ liquidity sources, split routes): output amount, slippage-protected minimum, USD value change, gas, hops. With `sender`, also an unsigned ready-to-sign transaction plus the ERC-20 allowance check. Quotes only; ISHOB never sends transactions.
- `crypto_prices` ($0.001 USDC per call): Live token prices computed from on-chain DEX pools (Uniswap V3, PancakeSwap V3, Orca Whirlpools) on Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain and Solana, with pool depth, confidence and 24h change; plus an Aave V3 yield screener (supply/borrow APY and market size per asset). No third-party price feed: every figure is derived from public chain state.
- `gas_tracker` ($0.0001 USDC per call): Real-time gas fees and network health for Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain and Solana: slow / standard / fast EIP-1559 fees (base fee + priority tip, from the last 20 blocks), cost of a transfer / ERC-20 transfer / swap in native token and USD, congestion, base-fee trend, block time and latest-block age; Solana priority-fee percentiles and TPS.
- `wallet_portfolio` ($0.001 USDC per call): Multi-chain wallet portfolio: native balances and token holdings with USD values and totals per chain. EVM addresses are checked on Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain (native + ~75 major tokens + up to 20 tokens you pass); Solana addresses list SOL and every SPL / Token-2022 holding. Prices come from on-chain DEX pools. Read-only public data.
- `simulate_tx` ($0.0015 USDC per call): Simulate a transaction before signing it: what leaves and enters the wallet (native, ERC-20, NFTs, SPL) with USD values, approvals granted (unlimited / to non-contracts), revert reason, gas and fee, plus a risk level. EVM chains via eth_simulateV1 (raw call: from, to, data, value); Solana via simulateTransaction (base64 transaction, unsigned is fine). Nothing is broadcast.
- `token_report` ($0.05 USDC per call): Token due diligence in one call: a 0-100 safety score and verdict (low-risk / caution / high-risk / avoid) with every deduction explained. Combines the token audit (honeypot, taxes, mint/blacklist/pause, LP lock, holders — Powered by GoPlus Security), a verified-contract scan for owner powers, price and real DEX liquidity, and live sell tests ($100 and $1,000 to USDC). Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Solana.
- `token_verdict` ($0.01 USDC per call): Should I touch this token? A fast plain-English verdict (low-risk / caution / high-risk / avoid) with a 0-100 score, the top 3 reasons, the good signals and the key facts (honeypot, taxes, liquidity, holders, owner). Rule-based, no AI: same token, same answer. Optional 1200x630 SVG share card. Powered by GoPlus Security plus on-chain checks and real DEX liquidity. Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Solana.
- `token_flows` ($0.01 USDC per call): Who is buying and selling a token right now: every on-chain transfer in the last 1h / 6h / 24h split into DEX buys, sells and wallet transfers. Returns buy vs sell volume and net flow in USD, unique buyers and sellers, top net buyers and sellers, the largest trades (with tx hashes) and an organic-activity score with wash-trading signals (round-tripping, volume concentration, repeated bot-size trades). Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain.
- `explain_transaction` ($0.005 USDC per call): Explain any mined transaction in plain English: what happened (swap, transfer, approval, NFT buy/sell/mint, wrap, contract deploy, failed + revert reason), the sender's net token changes with USD values, every token and native-coin movement, approvals granted, the function called (named from the verified ABI or a signature database, with decoded arguments) and the fee. Rule-based, no AI. Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain.
- `resolve_name` ($0.001 USDC per call): Resolve ENS names and Basenames both ways. name -> Ethereum address, Base address and profile records (avatar, description, url, email, Twitter/X, GitHub, Discord, Telegram) and whether it is that address's primary name; address -> its primary ENS name and primary Basename, each verified to resolve back to the same address. Works for .eth, *.base.eth, subnames and offchain (CCIP-Read) names. Unknown name or address = 404, not charged.
- `wallet_report` ($0.03 USDC per call): Wallet risk & activity report in one call — vet a counterparty before you transact: the address's own reputation (sanctions, phishing, theft, laundering, mixer... Powered by GoPlus Security), open token approvals with risky spenders, scam tokens held, and the full portfolio with USD values across Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain (or Solana: holdings only). Verdict: clean / caution / high-risk / flagged / incomplete, with every reason listed.
- `company_snapshot` ($0.05 USDC per call): Company snapshot in one call for any SEC-registered company: fundamentals and ratios from the latest annual report (revenue, margins, growth, debt, cash flow, EPS), SEC profile (industry, exchange, state, fiscal year), recent filings (latest 10-K / 10-Q, 8-K events, insider-trading activity in 90 days) and the official website's health (uptime, TLS expiry, email security, registration). Sources: SEC EDGAR (public domain), Wikidata (CC0).
- `site_audit` ($0.02 USDC per call): Full website audit in one call: an A-F grade with four 0-100 scores (performance, SEO, security, availability) and every issue listed with a fix. One real browser load gives Core Web Vitals, SEO of the rendered page (title, description, headings, canonical, alt text, Open Graph, JSON-LD) and an optional screenshot; plus uptime, HTTP→HTTPS redirect, TLS expiry, security headers, SPF/DMARC email security, domain registration, robots.txt and sitemap. robots.txt respected; nothing stored.
- `research_brief` ($0.05 USDC per call): Research brief on any topic in one call: the best papers from ISHOB's open-licence archive, filled with a live search of 250M+ scholarly works, each with authors, year, venue, DOI and citations; abstracts only for openly licensed papers (CC0 / public domain / CC BY / CC BY-SA), metadata and link for the rest; plus a short AI synthesis citing the papers as [n]. Checked before payment: if nothing is found anywhere the answer is a free 404 'not_covered'.
- `location_report` ($0.01 USDC per call): Location risk report in one call: resolve a place name (or reverse-geocode lat/lon), then weather risk for the next hours (drone-safe, outdoor-event risk, wind, rain, frost, extremes), local time, today's sunrise / sunset / daylight, and country facts (region, population, GDP, income group). For logistics, travel, events and drone planning.
- `set_agent_alarm` ($0.001 USDC per call): Schedule a signed webhook to wake an AI agent later: ISHOB POSTs your JSON payload to your https callback at deliver_at or after delay_seconds (60 s to 30 days ahead), retrying failed deliveries (1, 5, 15, 30, 60 min). Each delivery carries X-ISHOB-Signature (HMAC-SHA256 with the signing_secret returned once). Free status: GET /v1/alarm/{id}; free cancel: POST /v1/alarm/{id}/cancel. Charged only when the alarm is accepted.
- `generate_barcode` ($0.001 USDC per call): Generate a barcode or QR code as SVG or PNG: QR, DataMatrix, PDF417, Code 128, Code 39, EAN-13, EAN-8, UPC-A, ISBN-13, ITF and GS1-128. EAN/UPC/ISBN check digits are computed (or verified, never silently replaced). QR and DataMatrix support colours, square/rounded/dot styles and (QR) a centre logo from an https URL. Every format is verified scannable. Returns SVG text or base64 PNG plus a data URI ready to embed in HTML, PDF or labels.
- `lookup_product_code` ($0.001 USDC per call): Look up a product barcode number: identify and validate EAN-13, EAN-8, UPC-A, UPC-E, GTIN-14, ISBN-13/10, ISSN and ISMN codes (wrong check digits are reported with the correct digit), convert between forms (GTIN-14, EAN-13, UPC-A, ISBN-10 <-> 13) and decode the GS1 prefix. Then fetch product data from open databases: name, brand, quantity, categories, image, labels, Nutri-Score (food, cosmetics, pet food via Open Food Facts) or title, authors, publisher and cover (books via Open Library).
- `read_barcode` ($0.001 USDC per call): Read barcodes and QR codes from an image (URL or base64): QR, Micro QR, DataMatrix, Aztec, PDF417, MaxiCode, EAN-13/8, UPC-A/E, Code 128/39/93, Codabar, ITF and DataBar. Finds every code in the picture, even rotated, small or inverted (phone photos, receipts, labels, screenshots), and returns each one's text, format, position and meaning (URL, Wi-Fi network, vCard, e-mail, phone, location, crypto payment URI, product GTIN). No code found = not charged.
- `search_specs` ($0.001 USDC per call): Full-text search over abstracts and full texts, with extracted technical specifications (values, ranges, tolerances, units). Numeric constraints like "50 Nm" are matched.
- `query_specs` ($0.001 USDC per call): Structured specification table filtered by quantity (e.g. accuracy, wavelength, range), unit family, unit and value range, with source document and license.

## HTTP API
- Free: [API overview](https://api.ishob.com/api), [catalog](https://api.ishob.com/api/catalog), [search](https://api.ishob.com/api/search?q=calibration), [topics](https://api.ishob.com/api/topics), [OpenAPI 3.1](https://api.ishob.com/openapi.json), [discovery](https://api.ishob.com/.well-known/ai-data.json)
- GET https://api.ishob.com/api/document/{id}: metadata, abstract, license ($0.001 USDC)
- GET https://api.ishob.com/api/document/{id}/fulltext: structured full text in sections ($0.01 USDC)
- GET https://api.ishob.com/api/document/{id}/references: parsed references ($0.002 USDC)
- GET https://api.ishob.com/api/topic/{slug}/content: whole-topic bundle ($0.5 USDC)
- POST https://api.ishob.com/v1/extract {"url": "..."}: live public web page to clean Markdown, robots.txt respected, never stored ($0.001 USDC)
- POST https://api.ishob.com/v1/search {"query": "torque sensor 50 Nm"}: full-text + technical-spec search ($0.001 USDC)
- POST https://api.ishob.com/v1/specs {"quantity": "wavelength", "unit": "nm", "min": 500, "max": 700}: specification table with source and license ($0.001 USDC)
- GET https://api.ishob.com/v1/metadata: Extract a page's title, meta tags, OpenGraph, Twitter card, canonical/icons/feeds and JSON-LD from the <head> only (no full DOM download, robots.txt respected, nothing stored). ($0.0002 USDC)
- GET https://api.ishob.com/v1/dataset/{key}: Static Knowledge Base: open, commercially reusable datasets (world cities, countries, ISHOB topics) by page, by id or by facet filter, with licence and attribution ($0.0001 USDC)
- GET https://api.ishob.com/v1/weather: Current weather and hourly forecast (MET Norway, CC BY 4.0) for a lat/lon, plus decision flags: drone_safe, event_risk (low/moderate/high), rain_expected, frost_risk, high_wind — with the thresholds used ($0.001 USDC)
- POST https://api.ishob.com/v1/domain: Domain intelligence: registration via RDAP (registrar, created/expiry dates, status, nameservers, DNSSEC; unregistered = likely available), DNS (A/AAAA/NS/MX/SPF/DMARC, email and DNS providers) and the homepage tech stack (CDN, hosting, server, CMS, frameworks, analytics, payments) with evidence. ($0.0004 USDC)
- GET https://api.ishob.com/v1/geocode: Offline geocoding (GeoNames + DB-IP, CC BY 4.0): exactly one of ip (IPv4/IPv6 -> country/region/city/lat,lon), q (place name, e.g ($0.001 USDC)
- POST https://api.ishob.com/v1/pdf-tables: Extract tables as structured JSON (rows, header, records keyed by column) from a public PDF (multi-column / ruled tables, up to 30 pages, 10 MB) or an HTML page (colspan/rowspan expanded) ($0.001 USDC)
- GET https://api.ishob.com/v1/finance: Fundamentals and ratios for a US-listed company from its latest annual SEC filing (10-K/20-F, public domain): revenue, net income, EPS, cash flow, debt, equity; debt-to-equity, current/quick ratio, margins, ROE/ROA, growth ($0.001 USDC)
- POST https://api.ishob.com/v1/screenshot: Render a public web page in headless Chromium (Cloudflare Browser Rendering) and return a screenshot (PNG/JPEG/WebP, base64) for vision models: viewport up to 1920x1920 (default 1920x1080) or full page up to 8000 px ($0.001 USDC)
- POST https://api.ishob.com/v1/ping-status: Uptime / API health check: is a URL up, HTTP status, response time, redirect chain, headers and security headers (edge), plus the TLS certificate (issuer, expiry date, days remaining, SAN, verification errors) ($0.0002 USDC)
- GET https://api.ishob.com/v1/feed-reader: Read a published RSS 2.0 / RSS 1.0 / Atom / JSON Feed (blogs, news, podcasts, Reddit, Mastodon, YouTube channel feeds) as clean JSON items: title, link, ISO dates, author, plain-text summary/content, categories, enclosures ($0.0003 USDC)
- POST https://api.ishob.com/v1/embed: Text embeddings for RAG / semantic search: one string or up to 100 strings -> L2-normalised vectors with open BAAI models on Cloudflare GPUs: bge-small-en-v1.5 (384-d, English, default) or bge-m3 (1024-d, multilingual) ($0.0002 USDC)
- GET https://api.ishob.com/v1/site-speed: Page speed & Core Web Vitals from a real headless-Chromium load (mobile or desktop): LCP, CLS, FCP, TTFB, total blocking time with good/needs-improvement/poor ratings, load timings, request count and page weight by resource type ($0.001 USDC)
- POST https://api.ishob.com/v1/render-doc: Render Markdown (tables, code, lists, headings) into a styled PDF (custom CSS, A4/Letter/Legal, page numbers), a Word DOCX or standalone HTML; returns a private download link valid for 24 hours ($0.001 USDC)
- GET https://api.ishob.com/v1/crypto/contract-abi: Verified smart-contract ABI (+ optional Solidity/Vyper source) for Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain from the open Sourcify registry: compiler, deployment, read/write function and event signatures, and proxy resolution to the implementation ABI ($0.001 USDC)
- POST https://api.ishob.com/v1/crypto/token-audit: Token safety & scam check for an ERC-20 (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain) or SPL mint (Solana): honeypot simulation, buy/sell tax, mint / blacklist / pause / owner privileges, LP lock, holder concentration (Powered by GoPlus Security) plus our own on-chain checks (proxy slots, owner, verified source, mint/freeze authority, Token-2022 extensions) ($0.001 USDC)
- GET https://api.ishob.com/v1/crypto/swap-route: Best DEX swap route and quote on Ethereum, Base, Arbitrum, Optimism, Polygon or BNB Chain via the KyberSwap aggregator (400+ liquidity sources, split routes): output amount, slippage-protected minimum, USD value change, gas, hops ($0.001 USDC)
- GET https://api.ishob.com/v1/crypto/prices: Live token prices computed from on-chain DEX pools (Uniswap V3, PancakeSwap V3, Orca Whirlpools) on Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain and Solana, with pool depth, confidence and 24h change; plus an Aave V3 yield screener (supply/borrow APY and market size per asset) ($0.001 USDC)
- GET https://api.ishob.com/v1/crypto/gas-tracker: Real-time gas fees and network health for Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain and Solana: slow / standard / fast EIP-1559 fees (base fee + priority tip, from the last 20 blocks), cost of a transfer / ERC-20 transfer / swap in native token and USD, congestion, base-fee trend, block time and latest-block age; Solana priority-fee percentiles and TPS. ($0.0001 USDC)
- GET https://api.ishob.com/v1/crypto/portfolio: Multi-chain wallet portfolio: native balances and token holdings with USD values and totals per chain ($0.001 USDC)
- POST https://api.ishob.com/v1/crypto/simulate-tx: Simulate a transaction before signing it: what leaves and enters the wallet (native, ERC-20, NFTs, SPL) with USD values, approvals granted (unlimited / to non-contracts), revert reason, gas and fee, plus a risk level ($0.0015 USDC)
- POST https://api.ishob.com/v1/crypto/token-report: Token due diligence in one call: a 0-100 safety score and verdict (low-risk / caution / high-risk / avoid) with every deduction explained ($0.05 USDC)
- POST https://api.ishob.com/v1/crypto/token-verdict: Should I touch this token? A fast plain-English verdict (low-risk / caution / high-risk / avoid) with a 0-100 score, the top 3 reasons, the good signals and the key facts (honeypot, taxes, liquidity, holders, owner) ($0.01 USDC)
- GET https://api.ishob.com/v1/crypto/token-flows: Who is buying and selling a token right now: every on-chain transfer in the last 1h / 6h / 24h split into DEX buys, sells and wallet transfers ($0.01 USDC)
- GET https://api.ishob.com/v1/crypto/explain-tx: Explain any mined transaction in plain English: what happened (swap, transfer, approval, NFT buy/sell/mint, wrap, contract deploy, failed + revert reason), the sender's net token changes with USD values, every token and native-coin movement, approvals granted, the function called (named from the verified ABI or a signature database, with decoded arguments) and the fee ($0.005 USDC)
- GET https://api.ishob.com/v1/crypto/resolve-name: Resolve ENS names and Basenames both ways ($0.001 USDC)
- GET https://api.ishob.com/v1/crypto/wallet-report: Wallet risk & activity report in one call — vet a counterparty before you transact: the address's own reputation (sanctions, phishing, theft, laundering, mixer.. ($0.03 USDC)
- GET https://api.ishob.com/v1/company-snapshot: Company snapshot in one call for any SEC-registered company: fundamentals and ratios from the latest annual report (revenue, margins, growth, debt, cash flow, EPS), SEC profile (industry, exchange, state, fiscal year), recent filings (latest 10-K / 10-Q, 8-K events, insider-trading activity in 90 days) and the official website's health (uptime, TLS expiry, email security, registration) ($0.05 USDC)
- POST https://api.ishob.com/v1/site-audit: Full website audit in one call: an A-F grade with four 0-100 scores (performance, SEO, security, availability) and every issue listed with a fix ($0.02 USDC)
- POST https://api.ishob.com/v1/research-brief: Research brief on any topic in one call: the best papers from ISHOB's open-licence archive, filled with a live search of 250M+ scholarly works, each with authors, year, venue, DOI and citations; abstracts only for openly licensed papers (CC0 / public domain / CC BY / CC BY-SA), metadata and link for the rest; plus a short AI synthesis citing the papers as [n] ($0.05 USDC)
- GET https://api.ishob.com/v1/location-report: Location risk report in one call: resolve a place name (or reverse-geocode lat/lon), then weather risk for the next hours (drone-safe, outdoor-event risk, wind, rain, frost, extremes), local time, today's sunrise / sunset / daylight, and country facts (region, population, GDP, income group) ($0.01 USDC)
- POST https://api.ishob.com/v1/alarm: Schedule a signed webhook to wake an AI agent later: ISHOB POSTs your JSON payload to your https callback at deliver_at or after delay_seconds (60 s to 30 days ahead), retrying failed deliveries (1, 5, 15, 30, 60 min) ($0.001 USDC)
- POST https://api.ishob.com/v1/barcode: Generate a barcode or QR code as SVG or PNG: QR, DataMatrix, PDF417, Code 128, Code 39, EAN-13, EAN-8, UPC-A, ISBN-13, ITF and GS1-128 ($0.001 USDC)
- GET https://api.ishob.com/v1/product-code: Look up a product barcode number: identify and validate EAN-13, EAN-8, UPC-A, UPC-E, GTIN-14, ISBN-13/10, ISSN and ISMN codes (wrong check digits are reported with the correct digit), convert between forms (GTIN-14, EAN-13, UPC-A, ISBN-10 <-> 13) and decode the GS1 prefix ($0.001 USDC)
- POST https://api.ishob.com/v1/barcode/read: Read barcodes and QR codes from an image (URL or base64): QR, Micro QR, DataMatrix, Aztec, PDF417, MaxiCode, EAN-13/8, UPC-A/E, Code 128/39/93, Codabar, ITF and DataBar ($0.001 USDC)
- GET https://api.ishob.com/v1/datasets: free catalogue of the open datasets served by /v1/dataset/{key}

## Research archive (behind the research tools)
- Open-licence papers: 160281; with structured full text: 88077; topics: 58
- Topics: Measurement & Metrology (`measurement-metrology`), Sensors & Instrumentation (`sensors-instrumentation`), Optics & Photonics (`optics-photonics`), Materials Science (`materials-science`), Artificial Intelligence (`artificial-intelligence`), Natural Language Processing & LLMs (`natural-language-processing`), Machine Learning (`machine-learning`), Medical Imaging (`medical-imaging`), Analytical Chemistry (`analytical-chemistry`), Computer Vision (`computer-vision`), Cybersecurity & Cryptography (`cybersecurity`), Quantum Computing & Quantum Physics (`quantum-computing`), Laser Calibration (`laser-calibration`), Signal & Image Processing (`signal-processing`), Robotics & Automation (`robotics-automation`), Energy Systems (`energy-systems`), Statistical Machine Learning (`statistical-learning`), Multi-Agent Systems & AI Agents (`multi-agent-systems`), Distributed, Cloud & Edge Computing (`distributed-cloud-computing`), Software Engineering (`software-engineering`), Networking, 5G & Internet of Things (`networking-iot`), Biomedical Engineering & Devices (`biomedical-engineering`), Astrophysics & Cosmology (`astrophysics`), Climate & Atmospheric Science (`climate-atmosphere`), Computational Biology & Bioinformatics (`computational-biology`), Genomics & Genetics (`genomics`), Neuroscience (`neuroscience`), Neural & Evolutionary Computing (`neural-evolutionary-computing`), Information Retrieval & Recommender Systems (`information-retrieval`), Human-Computer Interaction (`human-computer-interaction`), Computer Architecture & Hardware (`computer-hardware`), Control Systems & Automation Engineering (`control-systems`), Speech & Audio Processing (`speech-audio`), Image & Video Processing (`image-video-processing`), Aerospace, Drones & Satellites (`aerospace-drones`), Environmental Engineering (`environmental-engineering`), Condensed Matter & Nanophysics (`condensed-matter`), Fluid Dynamics & CFD (`fluid-dynamics`), Applied Physics (`applied-physics`), Geoscience & Seismology (`geoscience`), Optimization & Operations Research (`optimization`), Chemistry & Catalysis (`chemistry-catalysis`), Nanotechnology (`nanotechnology`), Torque Calibration (`torque-calibration`), Pressure Calibration (`pressure-calibration`), Temperature Calibration (`temperature-calibration`), Nondestructive Testing (`nondestructive-testing`), Databases & Data Management (`databases-data-management`), Algorithms & Data Structures (`algorithms-complexity`), Information Theory & Coding (`information-theory`), Particle & High-Energy Physics (`particle-physics`), Plasma Physics & Fusion Energy (`plasma-fusion`), Computational Physics & Simulation (`computational-physics`), Numerical & Applied Mathematics (`numerical-mathematics`), Statistics & Data Analysis (`statistics-methodology`), Biophysics (`biophysics`), Superconductivity (`superconductivity`), Pipette Calibration (`pipette-calibration`)

## Payment protocol (x402 v2)
- A paid HTTP endpoint answers 402 with a base64 `PAYMENT-REQUIRED` header (scheme `exact`, network, USDC amount, payTo).
- Retry the same request with a `PAYMENT-SIGNATURE` header produced by an x402 client (e.g. @x402/fetch); the response carries a `PAYMENT-RESPONSE` settlement receipt.
- Network: eip155:8453 (Base); asset: USDC; payTo: 0x906F87F107B4675dD890b3f8EB2d51885E50e09d

## Licensing
Only openly licensed content (CC0, public domain, CC BY, CC BY-SA) is published as full text. Every response includes license, license_url and attribution that must be preserved. Details: https://ishob.com/data-rights