Agent Zero

Agent Zero Public API

Free endpoints — no payment, no auth.

Documentation GitHub OpenAPI

Operations 15

GET /v1/public/stats Aggregate ecosystem stats (counts only, no PII) #

GET /v1/public/leaderboards Free leaderboards (top MCP / OpenAPI / most-recent) #

GET /v1/public/agent/{chain}/{agent_id} Free counts-only detail for one agent #

GET /v1/public/capability/{slug} Stamped-readiness agents matching a capability slug #

GET /v1/public/chain/{chain} Stamped-readiness agents on a chain (base|ethereum) #

GET /v1/public/badge/{chain}/{agent_id}.svg Embeddable ERC-8004 verification badge (SVG) #

GET /v1/public/datasets Machine-readable index of every citable dataset we publish (CC BY 4.0)… #

GET /v1/public/datasets/{slug} One citable dataset descriptor by slug (commerce-backed|chain-liveness|signpost… #

GET /v1/public/openapi.json Curated OpenAPI 3.1 spec (public + paid endpoints) #

GET /v1/public/docs Human-readable API docs (Redoc renders the OpenAPI spec) #

GET /agent.json Agent Zero's ERC-8004 tokenURI manifest (JSON) #

GET /.well-known/agent-card.json A2A/ERC-8004 AgentCard (well-known path) #

GET /.well-known/agents.json Plural A2A/ERC-8004 multi-agent manifest — array form enumerated by agent… #

POST /mcp Free MCP server (4 read-only tools + x402 upsell) #

GET /.well-known/x402.json x402 v2 payment-discovery manifest — every paid endpoint's accepts[], pricing… #

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/onchainagentintel-io:onchainagentintel-io-public-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

openapi: 3.2.0
info:
  title: Agent Zero — ERC-8004 Agent Readiness & Trust intelligence…
  version: 1.9.0
  summary: 'Machine-discoverable API for the ERC-8004 agent economy on Base and Ethereum — a trust filter over the on-chain registry: indexes registered agents, enriches with live endpoint probes and payment activity, and scores each for readiness and trust.'
  description: Curated public spec covering (a) the free `/v1/public/*` and discovery surfaces (`/agent.json`, `/.well-known/agent-card.json`, `/mcp`) and (b) the paid x402 intelligence endpoints (`/v1/intel/*`, `/v1/audit`, `/v1/evaluate`).
  contact:
    name: Agent Zero
    url: https://onchainagentintel.io
  license:
    name: Public API — no license claim
    url: https://onchainagentintel.io/docs
servers:
- url: https://api.onchainagentintel.io
  description: Public API
tags:
- name: Public
  description: Free endpoints — no payment, no auth.
paths:
  /v1/public/stats:
    get:
      tags:
      - Public
      summary: Aggregate ecosystem stats (counts only, no PII)
      operationId: public_v1_public_stats_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /v1/public/leaderboards:
    get:
      tags:
      - Public
      summary: Free leaderboards (top MCP / OpenAPI / most-recent)
      operationId: public_v1_public_leaderboards_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /v1/public/agent/{chain}/{agent_id}:
    get:
      tags:
      - Public
      summary: Free counts-only detail for one agent
      operationId: public_v1_public_agent_chain_agent_id_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
          enum:
          - base
          - ethereum
      - name: agent_id
        in: path
        required: true
        schema:
          type: integer
          minimum: 0
        description: ERC-8004 agentId
  /v1/public/capability/{slug}:
    get:
      tags:
      - Public
      summary: Stamped-readiness agents matching a capability slug
      operationId: public_v1_public_capability_slug_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          maxLength: 40
        description: Lowercase capability slug (e.g. `defi`, `trading`).
  /v1/public/chain/{chain}:
    get:
      tags:
      - Public
      summary: Stamped-readiness agents on a chain (base|ethereum)
      operationId: public_v1_public_chain_chain_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
          enum:
          - base
          - ethereum
  /v1/public/badge/{chain}/{agent_id}.svg:
    get:
      tags:
      - Public
      summary: Embeddable ERC-8004 verification badge (SVG)
      operationId: public_v1_public_badge_chain_agent_id_svg_get
      responses:
        '200':
          description: Success
          content:
            image/svg+xml:
              schema:
                type: string
      parameters:
      - name: chain
        in: path
        required: true
        schema:
          type: string
          enum:
          - base
          - ethereum
      - name: agent_id
        in: path
        required: true
        schema:
          type: integer
          minimum: 0
        description: ERC-8004 agentId
  /v1/public/datasets:
    get:
      tags:
      - Public
      summary: Machine-readable index of every citable dataset we publish (CC BY 4.0)…
      operationId: public_v1_public_datasets_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /v1/public/datasets/{slug}:
    get:
      tags:
      - Public
      summary: One citable dataset descriptor by slug (commerce-backed|chain-liveness|signpost…
      operationId: public_v1_public_datasets_slug_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          enum:
          - commerce-backed
          - chain-liveness
          - signpost-gap
          - x402-bazaar
        description: Dataset slug — one of the enumerated citable datasets.
  /v1/public/openapi.json:
    get:
      tags:
      - Public
      summary: Curated OpenAPI 3.1 spec (public + paid endpoints)
      operationId: public_v1_public_openapi_json_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /v1/public/docs:
    get:
      tags:
      - Public
      summary: Human-readable API docs (Redoc renders the OpenAPI spec)
      operationId: public_v1_public_docs_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /agent.json:
    get:
      tags:
      - Public
      summary: Agent Zero's ERC-8004 tokenURI manifest (JSON)
      operationId: public_agent_json_get
      responses:
        '200':
          description: ERC-8004 tokenURI manifest
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /.well-known/agent-card.json:
    get:
      tags:
      - Public
      summary: A2A/ERC-8004 AgentCard (well-known path)
      operationId: public_well_known_agent_card_get
      responses:
        '200':
          description: A2A/ERC-8004 AgentCard
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /.well-known/agents.json:
    get:
      tags:
      - Public
      summary: Plural A2A/ERC-8004 multi-agent manifest — array form enumerated by agent…
      operationId: public__well-known_agents_json_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /mcp:
    post:
      tags:
      - Public
      summary: Free MCP server (4 read-only tools + x402 upsell)
      description: JSON-RPC 2.0 endpoint speaking the Model Context Protocol. Exposes read-only ecosystem stats and free leaderboards; paid intel lookups return an x402 upsell pointing at /v1/intel/*. Free — no X-PAYMENT header required.
      operationId: public_mcp_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - jsonrpc
              - method
              properties:
                jsonrpc:
                  type: string
                  example: '2.0'
                method:
                  type: string
                  example: tools/list
                params:
                  type: object
                  additionalProperties: true
                id:
                  oneOf:
                  - type: string
                  - type: integer
      responses:
        '200':
          description: JSON-RPC 2.0 response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /.well-known/x402.json:
    get:
      tags:
      - Public
      summary: x402 v2 payment-discovery manifest — every paid endpoint's accepts[], pricing…
      operationId: public__well-known_x402_json_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
components:
  securitySchemes:
    x402:
      type: apiKey
      in: header
      name: X-PAYMENT
      description: x402 payment envelope (base64-encoded JSON). Paid endpoints return HTTP 402 with an `accepts[]` list of accepted payment methods (USDC on Base/Ethereum via EIP-3009, or native ETH). Sign a payment authorization matching one of those entries, base64-encode it, and retry with this header set to receive the 200 response. See https://onchainagentintel.io/docs and https://api.onchainagentintel.io/agent.json for the full flow.
      x-x402:
        version: 1
        settlement_networks:
        - base
        - ethereum
        pay_to: '0xaCd134d2AAd0b868EDb395F7d151864188caaF1a'
externalDocs:
  description: Human docs, pricing, payment flow.
  url: https://onchainagentintel.io/docs