Ticker Bar

Track the markets you care about from the macOS menu bar. Ticker Bar combines stocks, crypto, exchange pairs, perpetual futures, on-chain tokens, and prediction markets in one fast, keyboard-first watchlist.

Browse markets	Manage your watchlist

Advanced editor	Menu bar

• Always visible — show the primary price or include its daily change, with an optional market logo beside the menu-bar title.
• Six market types — stocks, CoinGecko crypto, Binance Spot, Binance perpetual futures, DEX tokens, and Polymarket outcomes.
• Cache-first and resilient — cached prices appear immediately; freshness, provider failures, and stale data are shown explicitly.
• Built for rate limits — requests are timed out, batched where providers support it, and cooled down after throttling.
• Keyboard-first management — search, add, inspect, reorder, make primary, refresh, and remove without leaving Raycast.
• Detailed quotes — inspect daily change, open, high, low, volume, market cap, funding, market state, provider, and update time when available.

• ↩ runs the primary action.
• ⌘ D opens market details.
• ⌘ ↑ / ⌘ ↓ reorders an asset.
• ⌃ X removes an asset.

Menu Bar Style — choose a style from the Menu Bar submenu in Ticker Bar:

• Primary Ticker
• Primary Ticker and Change

Menu Bar Logo — toggle Logo: On / Off inside the Menu Bar style submenu. When enabled, real provider artwork appears beside the macOS menu-bar title. Dropdown rows retain their colored direction chevrons; logos also appear in Browse Markets, Manage Watchlist, and market details.

USD, CAD, EUR, or GBP for CoinGecko crypto quotes. Stocks, exchange pairs, futures, DEX tokens, and prediction markets remain in their provider-native USD or quote-currency representation.

Enter one asset per line. Blank lines and comments beginning with # are ignored.

stock:AAPL
crypto:bitcoin
binance:BTCUSDT
binanceperp:BTCUSDT
token:base:0x4200000000000000000000000000000000000006
polymarket:540817:yes

Bare stock symbols such as SPY and bare EVM contract addresses are normalized automatically. Invalid entries are reported instead of being silently discarded.

Ticker Bar stores the watchlist and quote cache locally through Raycast. It sends only the identifiers needed for quote and search requests to the selected data providers. A failed refresh never replaces the last valid quote; instead, the cached quote is marked stale with the provider error and last successful update time.

Provider-specific cache windows range from one to five minutes. Manual refresh bypasses those windows, while rate-limit cooldowns are still respected to avoid repeatedly hammering a throttled service.

• Stocks: Yahoo Finance
• Stock and ETF logos: Financial Modeling Prep
• Crypto: CoinGecko
• Binance Spot: Binance public market-data API
• Binance perpetual futures: Binance USDⓈ-M Futures
• On-chain tokens: DEX Screener
• Prediction markets: Polymarket Gamma API

Availability and fields vary by provider and market. Ticker Bar labels the provider on every quote.

Ticker Bar currently installs as a development extension while the public Raycast Store submission is prepared.

Requirements:

• macOS with Raycast installed
• Node.js 22 or newer

After cloning or downloading the repository:

npm install
npm run dev

Raycast will register the local extension and keep it updated while the development process is running.

npm install
npm test
npm run lint
npm run build

The tests cover asset-ID normalization, display formatting, freshness filtering, failure states, request batching, and Polymarket outcome math.

Command views import from src/market.ts, a stable public façade. The implementation is split by responsibility:

• market-storage.ts owns watchlist, primary-asset, quote, and status persistence.
• market-refresh.ts owns freshness windows, concurrency, cooldowns, and the cross-command refresh lock.
• providers/ contains one adapter per external data source plus the quote and search dispatcher.
• market-ids.ts, market-format.ts, and market-types.ts contain pure domain logic shared by commands and providers.

Keep provider-specific response types and normalization inside their adapter. New commands should use the market.ts façade rather than importing provider modules directly.

assets/       Public extension icon
media/        Images linked from the public README
metadata/     Raycast Store screenshots
src/          Commands, domain modules, and provider adapters
tests/        Pure logic and resilience tests

Before opening a contribution, run:

npm test
npm run lint
npm run build

• A quote shows a warning: open Market Details to see the last successful update and provider error, then try Refresh Prices after the cooldown.
• A symbol is not found: search in Browse Markets first. The advanced editor accepts exact provider identifiers, not fuzzy names.
• A DEX token resolves incorrectly: use the chain-qualified form, such as token:base:0x….
• The menu title is empty: choose a text-based Menu Bar Style and set a primary asset in Manage Watchlist.