# Ylalo docs

Trading API for AI agents. **www is mainnet (real funds)**. Sandbox hosts are play money. Agents cannot withdraw.

- [Quickstart](/docs/quickstart) ([.md](/docs/quickstart.md)) — OTP-first mainnet setup and first protected trade. Phone-free sandbox on sandbox.ylalo.com.
- [MCP install](/docs/mcp) ([.md](/docs/mcp.md)) — Connect Cursor, Claude Code, Claude.ai, ChatGPT, VS Code, or any MCP client to Ylalo.
- [Auth](/docs/auth) ([.md](/docs/auth.md)) — Sandbox keys, phone OTP, and scoped ylk_ API keys.
- [Orders](/docs/orders) ([.md](/docs/orders.md)) — Intent orders (/v1/orders), suggest, confirm, close, cancel.
- [Guardians & stops](/docs/guardians) ([.md](/docs/guardians.md)) — Server-side guardians and dead-man protection while the agent sleeps.
- [Market data](/docs/market-data) ([.md](/docs/market-data.md)) — Search markets, candles, and order book.
- [Limits](/docs/limits) ([.md](/docs/limits.md)) — Platform and optional user self-limits.
- [Errors](/docs/errors) ([.md](/docs/errors.md)) — Error envelope and what to do next.
- [Idempotency](/docs/idempotency) ([.md](/docs/idempotency.md)) — Idempotency-Key on write routes.
- [Events](/docs/events) ([.md](/docs/events.md)) — Cursor event feed, trades, and webhooks for Ylalo agents.
- [Conventions](/docs/conventions) ([.md](/docs/conventions.md)) — Units, decimals, timestamps, quote currency.
- [Changelog](/docs/changelog) ([.md](/docs/changelog.md)) — Human changelog page; machine feed at /v1/changelog.
- [FAQ](/docs/faq) ([.md](/docs/faq.md)) — Agent and human FAQ for Ylalo.
- [Recipe: first protected trade](/docs/recipes/first-protected-trade) ([.md](/docs/recipes/first-protected-trade.md)) — End-to-end auth → suggest → dryRun → confirm → guardians.

Also: [/llms.txt](/llms.txt) · [/llms-full.txt](/llms-full.txt) · [/agent.json](/agent.json) · [/v1/openapi.json](/v1/openapi.json) · [/v1/start](/v1/start)