michaelshimeles/terminal-rs

选用指南

AI 根据 README 整理 · 2026/10/20 12:06:52

使用方式

通过命令行运行，支持多种环境变量配置数据源和离线模式。

查看 README 依据

TR_PROVIDER=sample cargo run --release # offline APCA_API_KEY_ID=… APCA_API_SECRET_KEY=… cargo run --release # Alpaca ``` Data lives in `~/Library/Application Support/terminal-rs` (macOS) or `$XDG_DATA_HOME/terminal-rs` (Linux), or `TR_DATA_DIR`. The first congress ingest covers the current and previous year (a few minutes; it runs in the background while you work). `cargo run -p tr-congress --example ingest -- congress.sqlite3` runs one ingest from the CLI. Appearance: `TR_THEME=light|dark|<theme name>` overrides the saved theme, `TR_MSAA=1|2|4|8` sets

部署要求

需要Rust环境编译运行，数据源无需API密钥，但连接券商需SnapTrade API密钥。

查看 README 依据

TR_PROVIDER=sample cargo run --release # offline APCA_API_KEY_ID=… APCA_API_SECRET_KEY=… cargo run --release # Alpaca ``` Data lives in `~/Library/Application Support/terminal-rs` (macOS) or `$XDG_DATA_HOME/terminal-rs` (Linux), or `TR_DATA_DIR`. The first congress ingest covers the current and previous year (a few minutes; it runs in the background while you work). `cargo run -p tr-congress --example ingest -- congress.sqlite3` runs one ingest from the CLI. Appearance: `TR_THEME=light|dark|<theme name>` overrides the saved theme, `TR_MSAA=1|2|4|8` sets

and lints the whole workspace for aarch64-apple-darwin from Linux (zig as the C cross-compiler; linking needs the macOS SDK). ## Brokerage setup (SnapTrade) Everything happens in **Settings › Brokerage**, with no commands needed. Open it from the sidebar (Portfolio › **Brokerage Settings**), the toolbar's View menu (**Brokerage Accounts…**), the gear button on any portfolio pane, or the setup screen; `PORT SETUP` still works too. 1. Create API keys (a client ID and consumer key) in the [SnapTrade dashboard](https://dashboard.snaptrade.com). Personal keys work too.

已知限制

演示账户不支持卖空，订单类型因券商而异，部分市场数据可能延迟或模拟。

查看 README 依据

are repriced with the terminal's live quotes where a market key exists. ## Trading (opt-in) The **demo account** needs no setup: it is a local paper-trading account (`demo-account.json` in the app data folder) with no commissions, no short selling and Day orders expiring at the 4 p.m. New York close. Switch to your brokerage accounts with the toolbar badge, `MODE LIVE`, or Settings › Trading (`DEMO` switches back). Live trading is **off** until you enable it in **Settings › Trading**, which asks you to acknowledge that confirmed orders are real. Then:

accepted the order; only a 4xx is reported as a rejection. Which order types a broker accepts varies and SnapTrade does not publish it per broker, so the preview is where unsupported combinations are rejected. Dollar amounts work only for market/day orders at brokers that support notional orders; fractional share quantities are refused up front at brokers SnapTrade reports as not supporting them. Settings › Trading also has an optional **maximum order value** and a default account. Trading access is read once per brokerage connection (`/authorizations`), cached for an hour (on

- **Options** (`AAPL OMON`, ⌘⇧O) — full chains from Yahoo for US equities, ETFs and indices (SPX via ^SPX): every expiration, calls and puts by strike with bid/ask/last, change, volume, open interest and IV, plus Black-Scholes greeks (Δ, Γ, Θ/day, vega) from each contract's IV, the dividend yield and the 3-month T-bill rate; in-the-money shading, spot line, ±10/±20/all strikes; offline mode shows a flagged simulated chain. - **Markets** — `WEI` world markets (Americas/EMEA/Asia-Pacific indices, futures, Treasuries, FX,