# Ticker

> Terminal stock, crypto, and derivatives price watcher with position tracking, cost basis lots, currency conversion, and grouped watchlists.

Stars: 6.3k · Language: Go · License: GPL-3.0 · Categories: Productivity

- Repository: https://github.com/achannarasappa/ticker
- Page: https://www.trmn.sh/tools/ticker

## Install

- Homebrew: `brew install achannarasappa/tap/ticker`
- winget: `winget install -e --id achannarasappa.ticker`
- Snap: `sudo snap install ticker`
- Snap: `sudo snap connect ticker:ticker-config`

## Overview

Ticker is a terminal application that displays live price quotes for stocks, crypto, and futures contracts and tracks the value of your positions. Run it with a watchlist on the command line (`ticker -w NET,AAPL,TSLA`) or define watchlists and holdings in a `~/.ticker.yaml` file. Quotes refresh every 5 seconds by default, configurable with `--interval`, and pre- and post-market quotes are supported.

Positions are defined as cost basis lots with `symbol`, `quantity`, `unit_cost`, and an optional `fixed_cost` such as a brokerage commission. Multiple lots can be entered for the same symbol, and negative quantities represent closed or short positions. Display flags such as `--show-summary`, `--show-positions`, `--show-fundamentals`, `--show-tags`, and `--show-separator` add total day change, weight, average cost, open/previous close/day range, and exchange or currency details. Sorting can be set to change percent, `alpha`, `value`, or `user` order.

Market data comes from Yahoo Finance by default. Symbol suffixes select other sources: `.CB` for Coinbase, including futures contracts, and `.X` for ticker's shorthand crypto symbols such as `SOL.X`. Other features include named groups of watchlists and lots that you cycle through with TAB and SHIFT+TAB, conversion to a local currency via ISO 4217 codes, handling of minor-unit quotes such as GBp, custom hex color schemes, and a local cache to speed up startup. `ticker print` outputs positions as JSON or CSV (`--format=csv`) for scripting.

It suits developers and investors who want to monitor markets and portfolio value without leaving the terminal. It runs on Linux, macOS, and Windows, and is also available as a Docker image.

### Installation

```bash
# via Homebrew
brew install achannarasappa/tap/ticker
```

```bash
# via winget
winget install -e --id achannarasappa.ticker
```

```bash
# via Snap
sudo snap install ticker
sudo snap connect ticker:ticker-config
```

![Ticker running in a terminal](https://media.trmn.sh/cached/a2a35b489e7e812fc9efffa808a801f8b9be8cf9d5e3d31a87d494962276e4fb.gif)

![Ticker with all display options enabled](https://media.trmn.sh/cached/10825ff9f6f259924497f09f56728780664a2370312ab6256be5aa6700289d79.png)

![Ticker with currency conversion](https://media.trmn.sh/cached/22d5ece59067626fb2f4521659fe7e86c9c7de65ed837b07d712719afa9f6608.png)

## Alternatives

- [gopass](https://www.trmn.sh/tools/gopass.md): Command-line password manager compatible with pass, supporting GPG encryption, Git versioning, and team collaboration (Go, 7.3k stars)
- [Pop](https://www.trmn.sh/tools/pop.md): Send emails from the terminal via a TUI or CLI flags, using Resend or SMTP, with Markdown bodies, attachments, and AI agent skill support. (Go, 2.9k stars)
- [circumflex](https://www.trmn.sh/tools/circumflex.md): Terminal-based Hacker News browser with vim-style navigation and built-in article reader (Go, 2.1k stars)
- [tz](https://www.trmn.sh/tools/tz.md): Interactive TUI tool for displaying and comparing times across multiple time zones simultaneously (Go, 902 stars)
- [Slides](https://www.trmn.sh/tools/slides.md): Terminal presentation tool that renders markdown files as slides, with in-slide code execution, pre-processing, live reload, and SSH serving. (Go, 11.7k stars)

---

Canonical: https://www.trmn.sh/tools/ticker