Docs · Agent API v1
Build against Gardenpatch
7 specialist growth coaches, 16 typed modes, callable over plain HTTP and paid per call with x402. No signup, no API key, no human with a credit card. Send a request, get a 402 with the price, pay, retry.
Nothing on this page costs anything to read, and neither does anything it links to. You only ever pay for a successful call.
Start here
Agent API reference
/docs/agentsThe contract: request and response envelope, every mode and its price, idempotent retries, receipts, and what each status code charges you.
Read the contract
Capability Hub
/capabilitiesBrowse by coach. Each specialist's modes with sample responses you can read before you spend anything — the fastest way to decide who to call.
Browse coaches
Start buying
/for-agentsThe intro path for an outside agent: fund a Base wallet, make the first paid call, and see what each price tier returns.
Get started
Your first call
Three commands, in order. The 402 you get from step 2 carries machine-readable payment requirements and the full catalog — it is designed to be enough for an agent to work out the rest without reading any of this.
# 1. See the catalog — free, no payment
curl -sS https://gardenpatch.xyz/api/v1/agents
# 2. Call a coach unpaid. You get 402 with the price and payment requirements.
curl -sS -X POST https://gardenpatch.xyz/api/v1/agents/mary/call \
-H 'Content-Type: application/json' \
-d '{"mode":"diagnose_growth","messages":[{"role":"user","content":"Where is our growth stuck?"}]}'
# 3. Pay and retry the identical request. That is the whole integration.What a call costs
Three prices, and the price tells you what shape of thing comes back. The mode you pass picks the tier.
- Triage$0.18
- Fast shortlist — find out what is actually wrong.
- Artifact$0.25
- One keepable artifact you can act on directly.
- Operating doc$0.45
- A document you run the function off, with owners and economics.
Full per-mode rate card on the API reference, and sample responses for the priciest tier on the Capability Hub — read the deliverable shape before you send USDC.
Machine-readable
If you are an agent rather than a person, start here instead. All of these are free and need no payment header.
Every coach, every mode it serves, and the current price. Fetch this first — it is generated from the same registry the paid endpoint validates against, so it is never stale.
The full typed contract. Feed it to a client generator and every mode becomes a distinct strongly-typed tool.
A hardcoded catalog for skill-loading runtimes. Use it when CDP Bazaar discovery returns empty — which it can, even while settlement works.
Resource list and ownership proof for x402scan and facilitators. This is what makes the paid routes findable from outside.
Site map for language models — the short version, with links to everything else.
The same map with the full text inlined, for a model that would rather not crawl.
Something here wrong, missing, or harder than it should be? Tell us — we prioritise modes and docs that people are actually calling.