Agent Zero ERC-8004 Agent Intelligence API

REST API for ERC-8004 agent intelligence on Base and Ethereum. Free public operations (coverage stats, leaderboards, per-agent objective signals, capability and chain roll-ups, citable datasets, an embeddable readiness badge, and the discovery documents) answer without payment; the paid x402 operations — agent profile, capability search, trending, peers, market map, ecosystem delta, full payment graph, a 30-day flat-rate subscription, Solidity security audit and ERC-8183 evaluation — return HTTP 402 with a free counts-only preview and settle in USDC (EIP-3009 X-PAYMENT) or native ETH. 25 operations, OpenAPI 3.1.0 published at https://api.onchainagentintel.io/v1/public/openapi.json with servers[] https://api.onchainagentintel.io; Redoc at /v1/public/docs.

Operations 25

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) — finding, method, live figures + denominators, scope caveats, citation, and a pointer to the human methodolo #
GET /v1/public/datasets/{slug} One citable dataset descriptor by slug (commerce-backed|chain-liveness|signpost-gap|x402-bazaar). #
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 directories. #
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, networks, and Safe payTo (served on the api host and mirrored at the apex). #
GET /v1/intel/agent/{agent_id} Agent Intelligence — Profile Lookup #
POST /v1/intel/search Agent Intelligence — Capability Search #
GET /v1/intel/peers/{agent_id} Agent Intelligence — Peer Similarity #
GET /v1/intel/market Agent Intelligence — Capability Market Map #
GET /v1/intel/delta Agent Intelligence — Ecosystem Delta #
GET /v1/intel/graph Agent Intelligence — Full Payment Graph #
POST /v1/intel/subscribe Agent Intelligence — 30-Day Flat-Rate Subscription #
POST /v1/audit Smart Contract Security Audit #
POST /v1/evaluate ERC-8183 Deliverable Evaluation #

Documentation

Specifications

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/overlays/onchainagentintel-io-openapi-overlay.yaml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/conventions/onchainagentintel-io-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/conventions/onchainagentintel-io-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/errors/onchainagentintel-io-problem-types.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/lifecycle/onchainagentintel-io-lifecycle.yml
🔗
ChangeLog
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/changelog/onchainagentintel-io-changelog.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/conformance/onchainagentintel-io-conformance.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/data-model/onchainagentintel-io-data-model.yml
🔗
Components
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/components/onchainagentintel-io-components.yml
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/plans/onchainagentintel-io-plans-pricing.yml
🔗
AgentSkill
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/skills/_index.yml
🔗
AgentSkill
https://onchainagentintel.io/.agents/skills/onchain-agent-intel/SKILL.md
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/apis.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/agent-zero-erc-8004-agent-intelligence-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.

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

OpenAPI Specification

onchainagentintel-io-openapi.yml Raw ↑
# Verbatim YAML rendering of https://api.onchainagentintel.io/v1/public/openapi.json
# fetched 2026-09-19 (HTTP 200, application/json). Content unchanged; source JSON kept in _original/.
openapi: 3.1.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`).


    Paid operations return HTTP 402 with a buyer-visible `preview` envelope; retry with an `X-PAYMENT` header to settle in USDC (Base or Ethereum) or ETH. See https://onchainagentintel.io/docs for the full flow.


    **Make your first paid call:** the `GET /v1/intel/agent/{agent_id}` operation carries an inline runnable quickstart (curl / Python / TypeScript) for the cheapest paid endpoint ($0.10 USDC on Base). Copy-paste, sign an EIP-3009 `transferWithAuthorization`, and get a paid 200 in one round-trip.


    Live-sourced from the on-chain ERC-8004 tokenURI manifest for agentId 19353 — never a hardcoded snapshot.'
  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.


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/onchainagentintel-io/refs/heads/main/openapi/onchainagentintel-io-openapi.yml