Become discoverable

Why this matters

If agents can't discover your API, they can't pay for it. With Bags there is no discovery document to build: your paywalled URL itself is the contract. Runtime 402 behavior is the source of truth, and Bags serves it for you.

Your x402 URL

Each agentic payment link is live at:

https://www.getbags.app/api/agent/link/pl-{paymentLinkId}

An unpaid request answers HTTP 402 with machine-readable payment instructions in the PAYMENT-REQUIRED header (per the x402 spec) — everything an agent needs to pay and retry:

curl https://www.getbags.app/api/agent/link/pl-a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "status": "payment_required",
  "message": "Payment required to access this x402 resource.",
  "scheme": "exact",
  "method": "GET",
  "networks": ["base"]
}

There is nothing to implement on the buyer side: any x402-capable client handles the payment automatically, retries with proof, and receives your API's response.

Catalog listing — automatic

Bags registers each agentic payment link as its own entry in the CDP Bazaar catalog. Your link's name and description become its public marketplace listing, so agents browsing the catalog find your API by name.

• The entry appears after the link's first successful live settlement (test-mode and testnet links are never listed).
• Metadata refreshes on subsequent settlements; deactivating a link drops its entry.

Publish it yourself too

Catalog listing is additive. Put your x402 URL where agents (and the humans steering them) already look:

• llms.txt on your domain — one line is enough (create the file if you don't have one):

- [My API (x402 pay-per-call)](https://www.getbags.app/api/agent/link/pl-{id}): $0.05 per request, USDC — no account or API key needed to pay

• /.well-known/agents.md or an agent-facing section in your README
• Your API docs and OpenAPI description
• MCP tool descriptions, agent-skill manifests, and directory listings

Wherever you list it, state the price, that it speaks x402, and that paying requires no signup. (If you set up via the quickstart prompt, your coding agent does this for you — it's Step 5 of the machine guide.)

Next