Ticker：终端行情与持仓监视器

项目简介

Ticker 是一个运行在终端里的行情监视与持仓跟踪工具，使用 Go 编写，以 TUI 形式在命令行中展示实时报价。它适合习惯在终端里工作、希望不离开命令行就能盯盘的用户。README 中的演示效果：

主要功能

• 实时股票与加密货币报价
• 跟踪股票持仓的市值与盈亏
• 支持同一标的的多笔成本基础（lots）
• 支持盘前、盘后报价
• 显示选项：--show-tags（币种、交易所、报价延迟）、--show-fundamentals（开盘价、前收盘、日内区间）、--show-separator（项目间分隔线）、--show-summary（当日涨跌、总市值、总变动）、--show-positions（权重、平均成本、数量）
• 排序：--sort 可选涨跌幅（默认）、alpha、value、user
• 分组：在配置里用 groups 定义多组自选与持仓，运行中按 <kbd>TAB</kbd> / <kbd>SHIFT+TAB</kbd> 切换
• 数据源：无后缀默认 Yahoo Finance；.CB 使用 Coinbase；.X 为 ticker 自带的简写符号（如 SOL.X）
• 货币换算：通过 currency 设置 ISO 4217 三位代码；支持以最小货币单位（如伦敦交易所的便士 GBp）报价的标的
• 自定义配色：在配置里用十六进制色值覆盖默认方案
• ticker print 将持仓以 JSON 或 CSV 打印到终端
• 启动数据缓存，可用 --no-cache 或 cache: false 关闭

开启全部显示选项后的界面：

安装与使用

可从 releases 页面 下载预编译二进制并放入 PATH，也可以使用下面的快捷安装：

homebrew

brew install achannarasappa/tap/ticker

linux

curl -Ls https://api.github.com/repos/achannarasappa/ticker/releases/latest \
| grep -wo "https.*linux-amd64*.tar.gz" \
| wget -qi - \
&& tar -xvf ticker*.tar.gz ticker \
&& chmod +x ./ticker \
&& sudo mv ticker /usr/local/bin/

windows

winget install -e --id achannarasappa.ticker

docker

docker run -it --rm achannarasappa/ticker

配置文件可通过 bind mount 挂载：-v ~/.ticker.yaml:/.ticker.yaml。

snap

sudo snap install ticker
sudo snap connect ticker:ticker-config

MacPorts（第三方维护）

sudo port selfupdate
sudo port install ticker

快速开始：

ticker -w NET,AAPL,TSLA

常用参数：--config（默认 ~/.ticker.yaml）、-i/--interval（刷新间隔，默认 5 秒）、-w/--watchlist（逗号分隔的标的列表）、--sort、--version、--debug（日志写入 ./ticker-log-<date>.log）。

配置文件示例（所有属性均为可选）：

# ~/.ticker.yaml
show-summary: true
show-tags: true
show-fundamentals: true
show-separator: true
show-positions: true
interval: 5
currency: USD
currency-summary-only: false
watchlist:
  - NET
  - TEAM
  - ESTC
  - BTC-USD # Bitcoin price via Yahoo
  - SOL.X # Solana price via Coinbase
  - BIT-30MAY25-CDE.CB # Bitcoin futures contract price via Coinbase
lots:
  - symbol: "ABNB"
    quantity: 35.0
    unit_cost: 146.00
  - symbol: "ARKW"
    quantity: 20.0
    unit_cost: 152.25
  - symbol: "ARKW"
    quantity: 20.0
    unit_cost: 145.35
    fixed_cost: 7.00 # e.g. brokerage commission fee
groups:
  - name: crypto
    watchlist:
      - SHIB-USD
      - VGX-USD
    lots:
      - symbol: SOL1-USD
        quantity: 17
        unit_cost: 159.10

.ticker.yaml 可放在用户主目录、当前目录或 XDG config home；不在自选列表但出现在 lots 里的标的会自动加入自选；同一标的写多条即可表示多笔成本基础；数量可为负数，用于表示已平仓、做空或借入资产。

打印持仓：

$ ticker --config=./.ticker.yaml print
[{"name":"Airbnb, Inc.","symbol":"ABNB","price":164.71,"value":16965.13,"cost":15038,"quantity":103,"weight":53.66651978212161},{"name":"Tesla, Inc.","symbol":"TSLA","price":732.35,"value":14647,"cost":15660,"quantity":20,"weight":46.33348021787839}]

加 --format=csv 可输出 CSV。

货币换算示例：

注意事项

• 使用 ticker print 时，配置文件中至少需要有一笔 lot 才能生成输出。
• v5.0.0 之后不再支持 Coincap（.CC）与 CoinGecko（.CG）数据源。
• 汇率仅在启动时获取一次，不同时间启动得到的换算结果可能不同；currency-disable-unit-cost-conversion 可让成本基础不参与换算。
• Snap 无法访问点文件，需要用 --config $HOME/ticker.yaml 指定配置文件。
• 若未设置 currency 且开启 show-summary，汇总值统一以 USD 计算，避免混用货币。
• 项目基于 GPL-3.0 许可证开源。

---

本作品整理自 GitHub 开源项目 achannarasappa/ticker，原作者 @achannarasappa，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。