Skip to main content
The API is public and needs no key. Responses are JSON. The full OpenAPI 3.1 spec is at /openapi.json, and every endpoint below can be tried in the playground.

Conventions

Errors

Every error has the same shape:
code is stable and safe to branch on; message is for people and its wording may change. The full list is on the Errors page.

Rate limits

Exceeding a limit returns 429 with code RATE_LIMITED.

Faucet

POST /faucet sends 0.0001 Base Sepolia ETH, enough for roughly 25 approve-and-buy rounds, to a wallet holding less than that. tUSDC needs no faucet: anyone can call faucet() on the market’s collateral token to mint 10,000.

Versions

/api/v2 is current. /api/agents/v1 still works for existing integrations but new code should use v2.