BotX402

BotX402 Agent API

The Agent API from BotX402 — 1 operation(s) for agent.

GitHub OpenAPI

Operations 1

GET /api/v1/agent/bots List active bots with input schemas #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/botx402-io/openapi/botx402-io-agent-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/botx402-io:botx402-io-agent-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

botx402-io-agent-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: hello@botx402.io
    name: botx402
    url: https://botx402.io/agents
  description: botx402 sells paid lookups and one-shot reports to AI agents and the people they work for, with no account or API key. Each catalog resource (a path with an x-payment-info price) is paid per call over x402 v2 (USDC on Base) or, where listed, MPP (tempo charge, USDC.e on Tempo). GET /api/v1/agent/bots lists the bots on offer (the list can be empty); each bot is paid per run over x402 v2, or by card through the MCP server at /mcp.
  license:
    name: Proprietary
  title: botx402 Agent API
  version: 0.1.0
  x-category: Data
  x-guidance: 'Catalog resources (each path below with an x-payment-info price) are paid per call: the first request returns 402 with an x402 v2 PAYMENT-REQUIRED header (USDC on Base) and, where listed, an MPP WWW-Authenticate: Payment challenge (tempo charge, USDC.e on Tempo); pay either and retry with PAYMENT-SIGNATURE or Authorization: Payment. Bots: POST https://api.botx402.io/api/v1/agent/<slug>/run with {"inputs": {...}} (each bot''s schema is in its requestBody). The first call returns 402 with a PAYMENT-REQUIRED header (x402 v2, USDC on Base); sign an EIP-3009 authorization for accepts[0] and retry with PAYMENT-SIGNATURE. The 200 response has receipt_id and access_token; poll /api/v1/agent/runs/<receipt_id> with X-Access-Token until completed. Assistants can use the MCP server at https://api.botx402.io/mcp instead (card checkout a person pays).'
  x-logo:
    altText: botx402
    url: https://botx402.io/icon-512.png
servers:
- url: https://botx402.io
tags:
- name: Agent
paths:
  /api/v1/agent/bots:
    get:
      operationId: listBots
      responses:
        '200':
          content:
            application/json: {}
          description: Array of bot summaries (slug, price, input schema, run URL)
      security: []
      summary: List active bots with input schemas
      tags:
      - Agent