# On-Chain Agent Intel

> Real-time intelligence on the ERC-8004 agent economy across Base, Ethereum,
> and BNB Chain. 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.

We continuously index and enrich ERC-8004 agents across three chains
(Base, Ethereum mainnet, BNB Chain), reach out to their advertised endpoints,
capture MCP tool manifests, OpenAPI specs, ERC-8004 reputation-registry
feedback, and payment activity, then surface a buyer-POV Readiness & Trust
score. Every paid response is served by [x402](https://datatracker.ietf.org/doc/html/draft-bb-httpbis-http-status-402):
an initial request returns `402 Payment Required` with a `preview` envelope
and `payment_options`; sign an EIP-3009 `transferWithAuthorization`, replay
the same request with `X-PAYMENT`, and receive the paid body in the same
response. No accounts, no API keys, no OAuth.

- 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.

## 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.

## Optional

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