SwarmIO Cloud API

Endpoints (27 live)

• POST /api/v1/x402/fetch — Fetch any public web page as readable text — a browser-grade fingerprint, boilerplate stripped, links kept — or just its links or its SEO metadata. Plain HTTP (JS-rendered and bot-walled pages are reported as such; a browser-driven read is a run). $0.02 per call, no account. (0.02 USDC on Base)
• POST /api/v1/x402/run/research — A cited, evidence-graded research report on any question: a swarm of agents searches the live web, reads the sources, cross-checks the claims, and grades its own evidence (sourced / partial / unsupported). Pay $1.05 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.05 USDC on Base)
• POST /api/v1/x402/run/astrology — A natal reading from server-computed chart positions (birth date required in the input as '- Birth date: YYYY-MM-DD'). Pay $0.50 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (0.5 USDC on Base)
• POST /api/v1/x402/run/quote — Quotes gathered for a stated service or purchase, compared. Pay $0.95 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (0.95 USDC on Base)
• POST /api/v1/x402/run/grants — Matching grants and funders for a stated organization and need, with deadlines and requirements. Pay $1.15 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.15 USDC on Base)
• POST /api/v1/x402/run/supply — A supply-chain brief on a product or component: suppliers, risks, alternatives. Pay $1.40 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.4 USDC on Base)
• POST /api/v1/x402/run/policy — A brief on a bill, rule, or policy area: status, positions, what changes and for whom, cited. Pay $1.35 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.35 USDC on Base)
• POST /api/v1/x402/run/money — A personal-finance plan around stated goals and numbers. Pay $0.95 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (0.95 USDC on Base)
• POST /api/v1/x402/run/trainer — A personalized, progressive training program from stated goals and constraints. Pay $0.70 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (0.7 USDC on Base)
• POST /api/v1/x402/run/wellness — A literature-grounded wellness plan around a stated goal. Pay $1.85 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.85 USDC on Base)
• POST /api/v1/x402/run/meals — A week of meals planned around stated goals, with a shopping list. Pay $1.10 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.1 USDC on Base)
• POST /api/v1/x402/run/trips — A researched itinerary: real inventory, prices, and timing for a destination and dates. Pay $1.25 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.25 USDC on Base)
• POST /api/v1/x402/run/seo — A severity-ranked SEO audit of a live site with an action plan — every finding verified against the site itself. Pay $1.40 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.4 USDC on Base)
• POST /api/v1/x402/run/product — A cross-retailer product scan: the same items priced across many stores, structured specs and reviews, ranked by price-to-value, bot walls included. Pay $0.25 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (0.25 USDC on Base)
• POST /api/v1/x402/run/finance — A data-grounded market brief: live prices and technicals, fundamentals, recent insider and congressional trades, a per-asset thesis and a comparison table — numbers pulled, not generated. Pay $1.20 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.2 USDC on Base)
• POST /api/v1/x402/run/news — A same-day, cross-outlet news digest on a topic or region, every item dated and attributed, with the primary source separated from corroboration. Pay $0.75 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (0.75 USDC on Base)
• POST /api/v1/x402/run/mentor — A learning plan for a stated skill: sequence, resources, milestones. Pay $1.50 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (1.5 USDC on Base)
• POST /api/v1/x402/run/horoscope — The sky right now, computed server-side, read for the caller. Pay $0.50 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once. (0.5 USDC on Base)
• POST /api/v1/x402/chat — One language-model completion, paid per call — the same engine the swarm runs on, in the OpenAI messages shape. Up to 24 messages in and 1024 tokens out. USD 0.02 per call, no account, no key. (0.02 USDC on Base)
• POST /api/v1/news/brief — Today's market-news brief in one call: the platform's newest published news digest synthesized with the live market wire into a cited bullet brief — every finding ends with its source URL. $0.05 per call, pay-only over x402 — no account, no free tier, no input required. (0.05 USDC on Base)

+7 more endpoints.

MCP tools (14)

SwarmIO https://ioswarm.io/mcp

• billing.balance — The caller's credit balance and plan state.
• billing.topup_terms — How to refill credits machine-to-machine: USDC on Base to a published address, verified on-chain. Returns the pay_to address, minimum, and rate. Public — no credentials needed.
• fetch — Read one report by the id search returned: the full markdown text with its citations and evidence header, plus title, url and metadata. Public reports need no key; a caller's own reports need theirs.
• market.pulse — FREE, no key, no account: live prices for BTC, ETH, SOL, AMZN and NVDA with the session's change, plus today's news — the platform's newest published news digest parsed into stories with source links, and the market wire's latest headlines. Refreshed every minute (prices) and every ten minutes (news). Call this first to see what the swarm's data looks like before spending anything.
• modes.list — The launchable modes with a one-line contract for each. Static; never charged, no credentials needed.
• news.brief — PAID, 5¢ per call over x402 (USDC on Base, no account): today's market-news brief — this platform's newest published news digest synthesized with the live market wire into a cited bullet list, every finding ending with its source URL. No input required; the settle happens over HTTP, where the payment headers live: this tool returns the exact steps. The FREE raw material it is written from is market.pulse on this same server (the digest stories and wire headlines, un-synthesized).
• route.classify — Classify a freeform request into the right mode (research, news, finance, astrology, …) before spending a run. Never charged.
• runs.cancel — Stop a running job.
• runs.get — A run's status and metadata. Poll until status is completed/failed/cancelled.
• runs.launch — Launch a run: agents search the web, read sources, and write a cited report — real work, done for the caller. BILLED from the caller's credits. Returns the run record; poll runs.get until completed, then runs.report. Modes: research, news, product, trips, trainer, finance, astrology, horoscope (astrology/horoscope take Birth date constraint lines — see https://ioswarm.io/llms.txt).
• runs.report — The finished, cited report for a completed run (report_text is markdown).
• runs.wait — Block until a run finishes, then return its record — and its report when it completed. Runs take 3–10 minutes; call this instead of polling runs.get in a loop. Returns early with timed_out=true after timeout_secs (default 90, max 240): call it again with the same run_id to keep waiting. Never charged.
• search — Search the swarm's published research: the featured shelf, the operator's daily news / markets / AI digests, and — when a key is presented — the caller's own reports. Every hit is a finished, cited, evidence-graded report. Returns {results:[{id,title,url}]}; pass an id to fetch. No key needed for the public corpus. (The research-connector contract: this is what a ChatGPT or Claude connector calls.)
• web.search — FREE, no key, no account: LIVE web search, 25 queries a day per caller, up to 5 results each ({results:[{url,title,snippet,published}], quota, report}). This is the open web, not the published corpus — for the platform's finished reports use `search`. Over the daily quota the paid leg is $0.02 per call over x402 (USDC on Base): POST https://ioswarm.io/api/v1/search with the same JSON body and no payment header, read the 402, sign the EIP-3009 authorization, re-send with X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2) — no account is created. The response's `report` field shows the one-call cited research brief (5¢, pay-only) for when raw results are not enough.