hl-tickers

README

hl-tickers

Lightweight TUI market watcher with 400+ markets supported across forex, equities, crypto, and indices. No accounts, no API keys, free to use

Features

Inspired by achannarasappa/ticker & Tucsky/aggr.

• One source. View 400+ markets (forex, equities, indexes, and crypto) - no juggling data sources
• Realtime by default. Websocket stream for live price & OHLC data
• Detailed Asset View Press Enter on any market for a full-screen view with price chart and selectable timeframes (1H/24H/7D/30D)
• Discovery-first. Press / to explore 400+ assets & indexes
• Positions & PnL (optional) Paste a public 0x address track live positions. Alternatively, manually add your positions in the .yaml config
• Fast cold start. First load caches all available markets (1-2s) subsequent starts are instant

Install / build

Requires Go 1.24.2+ (latest stable recommended)

go build -o hl-tickers .

./hl-tickers --no-prompt

Usage

./hl-tickers                      # first run prompts (optionally) for a wallet
./hl-tickers --no-prompt          # skip the prompt
./hl-tickers --add BTC,GOLD,SPX   # preload symbols for this run
./hl-tickers --version

Set a wallet (for live perp positions) via the first-run prompt, the in-app w key, or the wallet: field in the config file.

Keys

Key	Action
/	Search all markets (crypto / equities / commodities)
↑ ↓ / j k	Move selection
shift+↑ ↓ / K J	Reorder the selected favourite (persists)
enter	Open the asset explorer (chart + live trades) for the selected row
enter (in search)	Add + favourite the highlighted asset
p	Open the portfolio viewer (if address is added)
f	Favourite / unfavourite the selected row
d / x	Remove the selected row
w	Add / change wallet address (live positions)
s	Cycle sort: manual → change% → alpha
F V R S	Toggle funding+OI · volume · 24h range · trend chart
q / esc / ctrl+c	Quit

In the asset explorer: t cycles the chart timeframe, f favourites, esc returns.

Symbols

1. Crypto perps — bare names (BTC, ETH, kPEPE).
2. HIP-3 builder perps — dex:SYM (xyz:GOLD, xyz:SP500). Displayed by their short symbol with a kind tag.
3. Aliases — names mapped to coins: OIL→xyz:CL, SPX→xyz:SP500, GOLD→xyz:GOLD, PEPE→kPEPE, …

Configuration

State is written to ~/.config/hl-tickers/config.yaml. No database

wallet: "0x…"            # optional public address
favourites:              # starred coins, in display order
  - BTC
  - ETH
  - xyz:GOLD
show_funding: false
show_volume: false
show_range: false
show_spark: true
show_summary: true

License

MIT

Attribution to this repo is appreciated.

Documentation

Overview

hl-tickers is a fast terminal market watcher. It shows live crypto, equity, and commodity prices and — with an optional public wallet address — your live perp positions. No API keys, no login, and 100% free.