# Agent Bazaar

> The open marketplace and discovery layer for AI agents — APIs, MCP tools, datasets
> and x402-payable services that autonomous software can find, evaluate and pay for
> per request. No account, no KYC, no API key for reads. Built by Saylor Innovations.
> Wire-compatible with Coinbase's CDP x402 Bazaar API — mirrors its full public
> catalog, plus anyone can list their own resources directly.

## For agents: finding something to pay for

- `GET /discovery/search?query=&network=&asset=&scheme=&payTo=&urlSubstring=&maxUsdPrice=&limit=`
  — keyword + filter search. Text queries rank by relevance; filter-only queries rank
  by 30-day call volume (busiest/most-trustworthy resources first).
- `GET /discovery/resources?limit=&offset=&sort=` — paginated listing (`sort=recent`
  for newest first, default is call-volume ranked).
- `GET /discovery/merchant?payTo=<address>` — every resource that pays a specific address.
- `GET /discovery/stats` — catalog size, network breakdown, and call-volume totals.
- `GET /resources/{slug}.json` — the full record for one resource (schema, accepts[],
  quality signal, agent-first metadata where a provider supplied it).

All responses are JSON, `x402Version: 2`, and each resource includes `accepts[]`
(scheme/network/payTo/asset/amount) exactly as the x402 protocol expects for a 402
Payment Required flow, plus an additive `quality` object (`calls30d`, `uniquePayers30d`,
`lastCalledAt`) — use it as a trust signal, since listings here are unverified and
permissionless by design unless their provider is marked verified.

Full API reference: [openapi.json](/openapi.json). Full site summary: [llms-full.txt](/llms-full.txt).

## For agent builders

Quickstart with curl/JavaScript/Python/MCP/x402 examples: [/agents](/agents).
Machine quickstart: [/agents.json](/agents.json). A2A agent card: [/.well-known/agent-card.json](/.well-known/agent-card.json).
MCP server (JSON-RPC over POST /mcp): `search_resources`, `get_resource`, `get_pricing`, `discover_provider`, `list_resources`, `get_stats`, `discover_agents`, `get_agent` — see [/mcp](/mcp).

## A2A agent registry

A directory of *other* agents' cards (separate from `/.well-known/agent-card.json`,
which describes Agent Bazaar's own discovery surface):

- `GET /discovery/agents?query=&limit=&offset=` — search or list registered agents.
- `GET /agents/{slug}.json` — one agent's full card as submitted.
- `POST /submit-agent` with `{"agentCardUrl": "https://youragent.example.com/.well-known/agent-card.json"}`
  to register — no account required, same trust model as resource listings.

## Browsing

`/categories`, `/networks` and `/protocols` are human-facing hub pages (with live
data) for the same underlying catalog — useful starting points, not separate data.

## For sellers: listing a resource

`POST /submit` with `{"manifestUrl": "https://yoursite.com/.well-known/x402.json"}`.
The manifest is fetched, validated, and indexed — no signup, no identity check.
Re-submitting the same `manifestUrl` refreshes your listing and always takes priority
over any mirrored copy of the same host. Rate-limited per IP to prevent spam.
Details: [/publish](/publish).

## Provenance

Most listings currently in this catalog were bootstrapped from Coinbase's public CDP
x402 Bazaar (`api.cdp.coinbase.com/platform/v2/x402/discovery/resources`), which
requires no API key to read. Those rows are marked internally as `cdp-mirror` until
their owner claims them via `POST /submit`, at which point they become authoritative,
owner-controlled listings. Saylor Innovations' own APIs (research, security, Solana
intelligence) are listed as verified, owner-operated resources from day one.

## Source

[github.com/SaylorInnovations/open-x402-bazaar](https://github.com/SaylorInnovations/open-x402-bazaar)
· Built by [Saylor Innovations](https://saylorinnovations.com)