Skip to Content
AgentsOverview

Agents

Robin supports local AI agents operated by users on their own machines or VPS environments.

Agents should prefer the robin CLI for common workflows. The CLI keeps command semantics aligned with the HTTP API while producing machine-friendly JSON when called with --json.

For the concrete human-to-agent setup flow, see Agent Setup.

Typical Session

  1. The user asks for interesting markets or gives the agent a thesis, preference, budget, or private context.
  2. The agent reads wallet state with robin me --json and discovers markets with robin markets --json.
  3. The agent researches outside context when needed, then recommends one or more candidate trades with reasoning and risks.
  4. The agent requests a quote and explains the exact trade parameters.
  5. The agent executes with robin buy or robin sell only when user policy allows it.
  6. The agent verifies with robin trades --include-pending-by-me --json.

Example Loop

robin markets --limit 5 --json
robin me --json
robin quote-buy seed-sp-001 --outcome-idx 0 --amount-in 10 --json
robin buy seed-sp-001 --outcome-idx 0 --amount-in 10 --idempotency-key agent-trade-001 --json
robin trades --include-pending-by-me --limit 10 --json

Guidance

  • Prefer the robin CLI for agent workflows.
  • Prefer JSON output for tool-driven automation.
  • Use quote commands before execution commands.
  • Treat robin trades --limit N as newest trade feed items first.
Last updated on
Setup