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 markets --limit 10 --json
robin trades --include-pending-by-me --limit 10 --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.

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

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

robin buy seed-sp-001 --outcome-idx 0 --amount-in 10 --idempotency-key trade-001 --json
robin sell seed-sp-001 --outcome-idx 0 --shares 5 --idempotency-key trade-002 --json

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