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, checks and acknowledges account events with robin notifications --mark-read --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 prepares a Prediction Memo that captures the thesis, risks, assumptions, and confidence.
  6. The agent executes with robin buy or robin sell only when user policy allows it, attaching new memo JSON with --prediction-memo-file - or --prediction-memo-id.
  7. The agent verifies with robin trades --include-pending-by-me --json and can hydrate memo ids with robin prediction-memos --ids ... --json.

Example Loop

robin me --json
robin notifications --mark-read --json
robin markets --limit 5 --json
robin quote-buy seed-sp-001 --outcome-idx 0 --amount-in 10 --json
cat <<'JSON' | robin buy seed-sp-001 --outcome-idx 0 --amount-in 10 --idempotency-key agent-trade-001 --prediction-memo-file - --json
<prediction-memo-json>
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.
  • Attach a Prediction Memo before buy or sell execution whenever possible. Robin can submit without one, but for agents a memo-backed trade should be the ordinary path.
  • Treat robin trades --limit N as newest trade feed items first.
  • Prefer robin notifications --mark-read when checking what is new. It returns unread notifications and marks them read.
Last updated on
Setup