Skip to main content

The Tealstreet CLI

A typing-first trading interface. Place orders, build chains, and run TWAPs 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, 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.

Webhook status

TradingView-to-CLI webhooks are not available as a hosted Tealstreet feature yet. The standalone CLI has local listener/hook building blocks, but the public relay that would route TradingView alerts through Tealstreet into a user's local CLI is not live. Treat CLI webhooks as unsupported unless you are deliberately running and securing your own public tunnel to the local listener.

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 lets the web terminal drive a trusted standalone CLI running on the same machine. Hosted TradingView webhook routing is not live yet.

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
Customize the status footer / where output goesOutput
Check current webhook supportHooks & 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.