Docs/Reference

Intent formatPlanned

For builders. The shape Sotto turns a sentence into before acting on it.

Request

POST /api/intent
{
  "text": "swap 10,000 USDG to ETH privately",
  "context": { "mode": "swap", "lastHost": null, "hasTrade": false, "liveOn": false }
}

Response

{
  "kind": "swap",  // swap | inspect | agent | live | lend | chat | unknown
  "swap": { "from": "USDG", "to": "ETH", "amountIn": 10000, "wantsPrivate": true },
  "host": null,
  "action": null,  // mint | claim | open | control | end | start
  "reply": null
}

The server holds the Anthropic API key and asks Claude to fill this shape. The key never reaches the browser.