Skip to main content

The Tealstreet CLI

A typing-first trading interface. Place orders, build chains, run TWAPs, and listen for webhooks — all from a prompt that feels like a shell and trades like a terminal.

:hltest [BTC-PERP $81,284.5] > buy $100 stop -1%
:hltest [BTC-PERP $81,284.5] > chase sell %all% 20% reduce to 1%
:hltest [BTC-PERP $81,284.5] > set ec; cancel; close; nuke

The CLI ships in two runtimes:

RuntimeWhereBest for
Web CLIA panel inside the trading terminalQuick fire-and-forget trades with the terminal already up
Standalone CLItealstreet binary on your machineWatch modes, recording, hooks, TradingView webhooks, leaving things running overnight

Same grammar, same commands, same constants. The web CLI is a strict subset — every standalone command except watch modes, hooks, recording, and a few host-process commands also works in the web CLI. See Web CLI vs standalone.


30-second tour

  1. Place orders by intent, not by form-filling. buy $100 is a $100 notional market buy on the focused symbol.
  2. Chain steps with ;. buy $100; cancel; close runs three things without waiting for round-trips — fire-and-don't-await is the default, and wait is how you opt into blocking when you need it.
  3. Variables and constants. $entry, $bid, $last, $pnl resolve live. User vars (@x) come from set for snapshots, sets for reactive expressions, track for high/low-water marks.
  4. Aliases for whole chains. alias z "cancel; close" lets you bind a common cleanup to one keystroke.
  5. Listener mode turns the standalone CLI into a webhook target — pair it with the web terminal or with TradingView alerts.

Where to go next

You want to…Read
Install the standalone CLIInstall
Run a few real recipesQuickstart
See every command in one pageCommands reference
Understand $entry, $bid, math, offsetsVariables & constants
Master ;, &, loops, wait, if, retryWorkflow
Send a TradingView alert into the CLIHooks & webhooks
Pair the web terminal to a standalone listenerPairing

House rules

  • Fire-and-don't-await. ; and & don't block on round-trips. If you need to wait, use wait or capture syntax.
  • Bare numbers are rejected as sizes. buy 100 errors with "USD or % required". Use $100, 100$, or 50%.
  • Reduce-only and post-only can be set per-order (buy … reduce, buy … po) or chain-wide (set ro / set po).
  • Simulation is a single toggle. Flip it on with sim on before trying anything new.