Commands

The CLI is organized around the standard trading loop: configure auth, inspect state, quote, execute, and verify.

Install

During internal testing, install the latest uploaded binary with:

curl -fsSL https://storage.googleapis.com/robin-downloads/cli/install.sh | sh

The installer detects macOS/Linux and arm64/x64, verifies SHA256SUMS, installs robin, and prints the installed version.

Version

robin --version

Use this when checking an installation or reporting CLI behavior.

Authentication

robin auth set-key
robin auth show
robin auth clear

robin auth set-key stores the API key in the local CLI config. You can also pass --api-key and --base-url explicitly.

Reads

robin me --json
robin notifications --mark-read --json
robin markets --limit 10 --json
robin trades --include-pending-by-me --limit 10 --json
robin prediction-memos --ids <memoId> --json

robin markets --limit N returns the first N markets from the API’s default market ordering.

robin trades --limit N returns the newest N trade feed items first. By default, the feed contains confirmed executions. Add --include-pending-by-me to include your unresolved submissions in the same newest-first feed.

robin notifications --mark-read --json returns unread notifications and marks them read, matching the notification-bell behavior in the UI. Use robin notifications --limit N to review the newest N notifications without changing read state.

Filter trade history to one or more markets with a comma-separated list:

robin trades --market-ids seed-sp-001,seed-po-002 --limit 10 --json

Trade feed items include predictionMemoId when a memo was attached. Read one or more memos by id:

robin prediction-memos --ids 0198f8c8-7f8d-7b15-9b30-70c5f9b5b6a1 --json

List memos for one or more markets:

robin prediction-memos --market-ids seed-sp-001,seed-po-002 --limit 20 --json

robin memos is a short alias for robin prediction-memos.

Quotes

robin quote-buy seed-sp-001 --outcome-idx 0 --amount-in 10 --json
robin quote-sell seed-sp-001 --outcome-idx 0 --shares 5 --json

Quote commands do not submit trades. Use them before execution to get fresh pricing and, when needed, wallet checks.

Execution

cat <<'JSON' | robin buy seed-sp-001 --outcome-idx 0 --amount-in 10 --idempotency-key trade-001 --prediction-memo-file - --json
<prediction-memo-json>
JSON

Use --idempotency-key when retrying buy or sell commands. Reusing the same key with a different trade intent returns a conflict.

Attach a Prediction Memo with --prediction-memo-file - when executing a new trade from an agent. This reads the memo JSON from stdin, so the agent does not need to create a local file before the user’s execution confirmation. Local file paths still work with --prediction-memo-file memo.json.

To reuse existing reasoning for another trade in the same market, attach a prior memo:

robin buy seed-sp-001 --outcome-idx 1 --amount-in 5 --idempotency-key trade-003 --prediction-memo-id 0198f8c8-7f8d-7b15-9b30-70c5f9b5b6a1 --json