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:
| Runtime | Where | Best for |
|---|---|---|
| Web CLI | A panel inside the trading terminal | Quick fire-and-forget trades with the terminal already up |
| Standalone CLI | tealstreet binary on your machine | Watch 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
- Place orders by intent, not by form-filling.
buy $100is a $100 notional market buy on the focused symbol. - Chain steps with
;.buy $100; cancel; closeruns three things without waiting for round-trips — fire-and-don't-await is the default, andwaitis how you opt into blocking when you need it. - Variables and constants.
$entry,$bid,$last,$pnlresolve live. User vars (@x) come fromsetfor snapshots,setsfor reactive expressions,trackfor high/low-water marks. - Aliases for whole chains.
alias z "cancel; close"lets you bind a common cleanup to one keystroke. - 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 CLI | Install |
| Run a few real recipes | Quickstart |
| See every command in one page | Commands reference |
Understand $entry, $bid, math, offsets | Variables & constants |
Master ;, &, loops, wait, if, retry | Workflow |
| Send a TradingView alert into the CLI | Hooks & webhooks |
| Pair the web terminal to a standalone listener | Pairing |
House rules
- Fire-and-don't-await.
;and&don't block on round-trips. If you need to wait, usewaitor capture syntax. - Bare numbers are rejected as sizes.
buy 100errors with "USD or % required". Use$100,100$, or50%. - 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 onbefore trying anything new.