Swarmio

Swarmio X402 API

The X402 API from Swarmio — 23 operation(s) for x402.

GitHub OpenAPI

Operations 26

GET /api/v1/x402/topup x402 top-up terms: resource URL, scheme, networks, asset, price bounds. #
POST /api/v1/x402/topup Buy credits over the x402 protocol. #
GET /api/v1/x402/run Every mode sold per run over x402, with its price in USD. Free. #
POST /api/v1/x402/run/research A cited, evidence-graded research report on any question: a swarm of agents… #
POST /api/v1/x402/run/news A same-day, cross-outlet news digest on a topic or region, every item dated and… #
POST /api/v1/x402/run/finance A data-grounded market brief: live prices and technicals, fundamentals, recent… #
POST /api/v1/x402/run/product A cross-retailer product scan: the same items priced across many stores… #
POST /api/v1/x402/run/seo A severity-ranked SEO audit of a live site with an action plan — every finding… #
POST /api/v1/x402/run/trips A researched itinerary: real inventory, prices, and timing for a destination… #
POST /api/v1/x402/run/trainer A personalized, progressive training program from stated goals and constraints. #
POST /api/v1/x402/run/meals A week of meals planned around stated goals, with a shopping list. #
POST /api/v1/x402/run/wellness A literature-grounded wellness plan around a stated goal. #
POST /api/v1/x402/run/mentor A learning plan for a stated skill: sequence, resources, milestones. #
POST /api/v1/x402/run/money A personal-finance plan around stated goals and numbers. #
POST /api/v1/x402/run/policy A brief on a bill, rule, or policy area: status, positions, what changes and… #
POST /api/v1/x402/run/supply A supply-chain brief on a product or component: suppliers, risks, alternatives. #
POST /api/v1/x402/run/grants Matching grants and funders for a stated organization and need, with deadlines… #
POST /api/v1/x402/run/quote Quotes gathered for a stated service or purchase, compared. #
POST /api/v1/x402/run/astrology A natal reading from server-computed chart positions (birth date required in… #
POST /api/v1/x402/run/horoscope The sky right now, computed server-side, read for the caller. #
GET /api/v1/x402/quote Describe this x402 primitive. #
POST /api/v1/x402/quote Live quotes for up to 8 symbols (stocks, ETFs, crypto pairs as X-USD, FX as… #
GET /api/v1/x402/fetch Describe this x402 primitive. #
POST /api/v1/x402/fetch A public web page as readable text, or its links, or its SEO metadata — paid… #
POST /api/v1/x402/chat One language-model completion, paid per call — the same engine the swarm runs… #
GET /api/v1/x402/supported Which x402 versions, schemes, networks, and extensions this resource speaks. #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/ioswarm-io/openapi/ioswarm-io-x402-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ioswarm-io:ioswarm-io-x402-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ioswarm-io-x402-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: SwarmIO Cloud X402 API
  version: 1.0.0
  description: 'The x402-payable and public agent surface of ioswarm.io — this root document is what agent discovery (x402scan register-origin, the agentcash probe) reads. The full contract, including the credit-billed account API (sk_swarm_ key), is at /api/v1/openapi.json; the human/agent doc is /llms.txt.


    AI that does real work for you. One POST kicks off a job that searches the web, reads sources, and writes a cited report; poll for the result.


    Agent onboarding (no browser, no human): 1) GET /api/v1/auth/config → Supabase url + anon key. 2) POST {supabase_url}/auth/v1/signup → access_token (email confirmation off). 3) POST /api/v1/agent/register → agent id. 4) POST /api/v1/account/api-keys → sk_swarm_ key (shown once). 5) Authorization: Bearer sk_swarm_… on everything else. Starter credits land automatically on the first authenticated call.


    The full agent doc is https://ioswarm.io/llms.txt; the A2A agent card is at /.well-known/agent-card.json; an MCP facade is at /mcp.'
  x-guidance: 'Agent surface. Paid x402 primitives answer a bare call with a 402 carrying the payment requirements (v1 in the body, v2 base64 in the PAYMENT-REQUIRED header): sign the EIP-3009 transferWithAuthorization they describe and re-send the identical request with X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2). Paid per call: /api/v1/search ($0.02, 25 free/day), /api/v1/search/report ($0.05), /api/v1/news/brief ($0.05), /api/v1/market/price ($0.02, 10 free/day), /api/v1/video/transcript ($0.02, 10 free/day), /api/v1/video/search ($0.02, 25 free/day), /api/v1/x402/quote ($0.01), /api/v1/x402/fetch ($0.02), /api/v1/x402/chat ($0.02), /api/v1/feeds/{feed} ($0.01-$0.02; a free 24h-delayed edition sits at /api/v1/feeds/{feed}/sample). Long-running jobs: POST /api/v1/x402/run/{mode} ($0.25-$1.85 per run; the paying wallet becomes the account). Credit-billed account surface (API key, not x402): GET /api/v1/auth/config to discover the Supabase backend, sign up (email confirmation is off), POST /api/v1/agent/register, then POST /api/v1/account/api-keys for an sk_swarm_ key.'
  contact:
    url: https://ioswarm.io
    email: support@ioservices.io
servers:
- url: https://ioswarm.io
tags:


# --- truncated at 32 KB (63 KB total) ---
# Full source: https://artifacts.apis.io/ioswarm-io/openapi/ioswarm-io-x402-api-openapi.yml