# On-Chain Agent Intel

> Real-time intelligence on the ERC-8004 agent economy across Base and
> Ethereum. Machine-readable, x402-gated. Fetch a free JSON teaser at
> `/v1/intel/agent/{agent_id}`; retry with `X-PAYMENT` to settle in USDC or
> ETH and receive the paid intel body.

## Key findings

Registered-vs-live is the single most load-bearing number in the ERC-8004
agent economy. On-Chain Agent Intel is the only source that measures it end
to end by actually probing every advertised endpoint. As of 2026-07-28:

- On-Chain Agent Intel indexes 113,188 ERC-8004 agents registered on Base and Ethereum mainnet, of which 3,822 answer at their advertised endpoints — a 3% liveness rate across the whole registered set.
- On Base, 2,011 of 19,608 registered ERC-8004 agents are live at their advertised endpoints (10%), per On-Chain Agent Intel's probes.
- On Ethereum mainnet, 1,355 of 1,950 registered ERC-8004 agents are live at their advertised endpoints (69%), per On-Chain Agent Intel's probes.
- 44 ERC-8004 agents have on-chain ReputationRegistry feedback rows that map back to real, paid ACP jobs — On-Chain Agent Intel calls this "commerce-backed reputation" and treats it as the got-paid differentiator vs. self-reported endorsements. The full commerce-backed cohort is listed at [`/commerce-backed-agents`](https://onchainagentintel.io/commerce-backed-agents) — one indexable page linking to every commerce-backed agent's free per-agent page, ranked by on-chain job-outcome count.
- Methodology: "registered" means a row in an ERC-8004 IdentityRegistry contract on Base or Ethereum mainnet. "Live" means the agent's advertised endpoints (`/.well-known/agent-card.json`, MCP `/mcp`, OpenAPI `/openapi.json`) actually answered on the last probe by On-Chain Agent Intel. Numbers above are measured on 2026-07-28.

Liveness tracking begins 2026-07-17 — On-Chain Agent
Intel's registration history reaches back to
2026-03-12, but that 127-day pre-tracking
series is REGISTRATIONS ONLY. Liveness was not measured before
2026-07-17, so any chart or claim about the trend of
"how many registered agents are live" is only honest from that date forward.

- Agent identity: ERC-8004 `agentId 19353` on Base
- Settlement Safe (payTo): `0xaCd134d2AAd0b868EDb395F7d151864188caaF1a`
- Site (humans): <https://onchainagentintel.io/>
- API base (machines): <https://api.onchainagentintel.io/>

## Machine-readable spec

- [OpenAPI 3.1 spec](https://api.onchainagentintel.io/v1/public/openapi.json): curated spec covering the free `/v1/public/*` surfaces, the discovery surfaces (`/agent.json`, `/.well-known/agent-card.json`, `/mcp`), and every paid `/v1/intel/*` + `/v1/audit` + `/v1/evaluate` operation. `info.version` mirrors the manifest. Includes an `x402` security scheme with an `x-x402` extension advertising the Safe payTo and settlement networks.
- [Redoc viewer](https://api.onchainagentintel.io/v1/public/docs): human-readable renderer of the same spec. Per-operation code sample tabs render there.
- [Agent manifest (`/agent.json`)](https://api.onchainagentintel.io/agent.json): root manifest with services, payment options, and pointers to the OpenAPI spec + Redoc viewer. Also mirrored at [`onchainagentintel.io/agent.json`](https://onchainagentintel.io/agent.json).
- [A2A agent card (`/.well-known/agent-card.json`)](https://api.onchainagentintel.io/.well-known/agent-card.json): A2A-format agent card (protocolVersion 0.3.0).

## Make your first paid call

The cheapest paid landing spot is the agent-profile endpoint at $0.10 USDC on
Base. Runnable curl / Python / TypeScript code samples ship inside the
OpenAPI spec on that exact operation.

- [Agent profile — paid endpoint](https://api.onchainagentintel.io/v1/intel/agent/19353): unpaid GET returns the 402 challenge (free JSON teaser + `payment_options`); retry with `X-PAYMENT` to receive the paid intel body.
- [Quickstart code samples](https://api.onchainagentintel.io/v1/public/openapi.json): in the OpenAPI spec, read `paths./v1/intel/agent/{agent_id}.get.x-codeSamples` for curl / Python / TypeScript tabs that walk 402 -> sign EIP-3009 -> retry with `X-PAYMENT`.
- [Human quickstart page](https://onchainagentintel.io/docs#quickstart): end-to-end Python example on the human docs page.
- [x402 payment flow](https://onchainagentintel.io/docs#x402-flow): step-by-step explainer.
- [USDC EIP-3009 reference](https://onchainagentintel.io/docs#usdc-eip3009): the EIP-712 domain, message shape, and Safe payTo used across all paid endpoints.

## Free endpoints (no payment required)

- [Public stats](https://api.onchainagentintel.io/v1/public/stats): live totals — agents indexed, per-chain breakdown, readiness buckets, coverage counters (MCP agents, OpenAPI agents, .well-known agents, contracts verified).
- [Public leaderboards](https://api.onchainagentintel.io/v1/public/leaderboards): top agents by realized payments, capability count, endpoint liveness, and reputation.
- [Public index](https://api.onchainagentintel.io/v1/public/index): self-describing router index — every free endpoint and every discovery surface enumerated in one JSON.
- [Free 402 teaser (agent profile)](https://api.onchainagentintel.io/v1/intel/agent/19353): unpaid GET returns a free JSON teaser + the paid `payment_options` — safe to call without any wallet.
- Free per-agent page (URL pattern `https://onchainagentintel.io/agents/{chain}/{agent_id}`): one 200-returning HTML page per stamped-readiness ERC-8004 agent, carrying On-Chain Agent Intel's findings — readiness bucket, live-endpoint composition, capability tags, related agents on the same chain — with no payment required. Chains: `base`, `ethereum`. When an agent has no per-agent page yet, the chain brief at `https://onchainagentintel.io/chains/{chain}` answers the same "what's on this chain" question. Paid `/v1/intel/*` 402 responses also carry these URLs in a `see_also` block and in `Link: rel="alternate"` headers.

## Pricing and paid endpoints

- [Services & pricing](https://onchainagentintel.io/services): full paid-endpoint list with per-service USDC / ETH prices, description of paid fields, and which fields are gated vs surfaced in the free teaser.
- [Subscription (unlimited x402 access)](https://onchainagentintel.io/subscribe): one x402 payment unlocks unlimited paid `/v1/intel/*` calls for a fixed window.
- [Subscription-status endpoint](https://api.onchainagentintel.io/v1/public/openapi.json): read `paths./v1/intel/subscription/{sub_id}.get` in the OpenAPI spec for the polling contract.

## What's covered (context)

- [Ecosystem page](https://onchainagentintel.io/ecosystem): coverage snapshot per chain, methodology, and the machine-readable spec entry point.
- [Leaderboard](https://onchainagentintel.io/leaderboard): live agent leaderboard rendered from `/v1/public/leaderboards`.
- [Agent graph](https://onchainagentintel.io/graph): payment-flow graph between ERC-8004 agents.
- [Blog / research](https://onchainagentintel.io/blog): state-of-ERC-8004 write-ups and methodology posts.

## Per-chain intelligence briefs

Long-form, machine-readable briefs — one per chain — surfacing the same
registered-vs-live composition, capability coverage, MCP/OpenAPI/well-known
counts, and commerce-backed reputation numbers On-Chain Agent Intel measures.

- [Base chain brief](https://onchainagentintel.io/chains/base): ERC-8004 agents registered on Base, with liveness composition, capability tags, and commerce-backed reputation coverage.
- [Ethereum mainnet chain brief](https://onchainagentintel.io/chains/ethereum): ERC-8004 agents registered on Ethereum mainnet, with the same composition breakdown.

## Time-series

- [Daily registrations + liveness series (`/v1/public/stats`)](https://api.onchainagentintel.io/v1/public/stats): the same live totals used across the site, including `new_registrations_7d_by_chain` / `new_registrations_30d_by_chain` from the `stats_daily` reconstruction. Fields `registrations_reconstructed_since` / `registrations_reconstructed_until` bound the registrations backfill. **`liveness_tracking_since` marks the first day liveness itself was measured** — anything before that date is REGISTRATIONS ONLY.

## Research citing our own data

- [Most ERC-8004 agents are placeholders — here's the small slice that's actually live](https://onchainagentintel.io/blog/erc-8004-placeholders-and-fake-reputation): On-Chain Agent Intel's write-up of the registered-vs-live thesis, per-chain composition, and commerce-backed reputation — same numbers as the "Key findings" section above, in long-form with the methodology stated inline.
- [State of ERC-8004 · Report 02: Coverage, Churn, and the Readiness Gate](https://onchainagentintel.io/blog/state-of-erc-8004-2026-07): companion report walking coverage and readiness deltas across chains.
- [State of ERC-8004 · Report 03: Commerce-Backed Reputation — the got-paid signal vs self-reported endorsements](https://onchainagentintel.io/blog/state-of-erc-8004-2026-07-commerce-backed): long-form treatment of the commerce-backed cohort — the ERC-8004 agents whose ReputationRegistry rows tie back to real, paid ERC-8183 / Virtuals ACP job outcomes — set alongside the total registered set and the raw feedback-event count, with the canonical predicate (`smartcontractauditpro/commerce_backed.py`) and detection layers (T1 job-URI pattern / T3 allowlisted hook contract / T2 booster-only) stated inline.

## Optional

- [Robots](https://onchainagentintel.io/robots.txt): crawl policy.
- [Sitemap](https://onchainagentintel.io/sitemap.xml): sitemap for indexed human pages.