raycast · kays0x · Jul 31, 2026 · Jul 31, 2026 · Aug 17, 2026 · Aug 17, 2026
diff --git a/extensions/ticker-bar/.gitignore b/extensions/ticker-bar/.gitignore
@@ -0,0 +1,4 @@
+node_modules
+dist
+.raycast
+.DS_Store
diff --git a/extensions/ticker-bar/CHANGELOG.md b/extensions/ticker-bar/CHANGELOG.md
@@ -0,0 +1,12 @@
+# Ticker Bar Changelog
+
+## [Initial Version] - {PR_MERGE_DATE}
+
+- Track stocks, crypto, Binance Spot pairs, Binance perpetual futures, on-chain tokens, and Polymarket outcomes from the macOS menu bar.
+- Show the primary ticker, optional daily change, and optional provider artwork in the menu bar.
+- Browse across providers and manage, reorder, inspect, refresh, or bulk edit a watchlist of up to 50 assets.
+- Open a quote detail view with daily statistics, volume, market cap, funding, market state, provider, and freshness metadata where available.
+- Render cached quotes immediately and refresh them with provider-specific TTLs, request timeouts, batching, retry cooldowns, and a cross-command refresh lock.
+- Preserve the last valid value when a provider fails, while clearly labeling stale and unavailable quotes.
+- Validate and normalize advanced asset IDs instead of silently accepting malformed entries.
+- Support USD, CAD, EUR, and GBP display for CoinGecko crypto quotes.
diff --git a/extensions/ticker-bar/README.md b/extensions/ticker-bar/README.md
@@ -0,0 +1,140 @@
+# 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.
+
+## Preview
+
+| Browse markets                                                                                 | Manage your watchlist                                                           |
+| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| ![Browse stocks, crypto, tokens, futures, and prediction markets](media/01-browse-markets.png) | ![Manage, reorder, and inspect watchlist assets](media/02-manage-watchlist.png) |
+
+| Advanced editor                                                               | Menu bar                                                                    |
+| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| ![Bulk edit exact market identifiers](media/03-advanced-watchlist-editor.png) | ![View live prices from the macOS menu bar](media/04-menu-bar-dropdown.png) |
+
+## Highlights
+
+- **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.
+
+## Commands
+
+| Command                       | Purpose                                                          |
+| ----------------------------- | ---------------------------------------------------------------- |
+| **Ticker Bar**                | Show the live menu bar item and watchlist dropdown.              |
+| **Browse Markets**            | Search every supported market type and add results.              |
+| **Manage Watchlist**          | Inspect, reorder, refresh, remove, or choose the primary asset.  |
+| **Advanced Watchlist Editor** | Bulk edit exact asset IDs, with validation and a 50-asset limit. |
+| **Update Market Data**        | Fetch fresh quotes and update the current watchlist cache.       |
+
+### Keyboard shortcuts
+
+- `↩` runs the primary action.
+- `⌘ D` opens market details.
+- `⌘ ↑` / `⌘ ↓` reorders an asset.
+- `⌃ X` removes an asset.
+
+## Preferences
+
+**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.
+
+### Currency
+
+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.
+
+## Advanced asset IDs
+
+Enter one asset per line. Blank lines and comments beginning with `#` are ignored.
+
+```text
+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.
+
+## Data behavior
+
+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.
+
+## Data sources
+
+- Stocks: [Yahoo Finance](https://finance.yahoo.com)
+- Stock and ETF logos: [Financial Modeling Prep](https://site.financialmodelingprep.com/)
+- Crypto: [CoinGecko](https://www.coingecko.com)
+- Binance Spot: [Binance public market-data API](https://developers.binance.com/docs/binance-spot-api-docs/rest-api/general-api-information)
+- Binance perpetual futures: [Binance USDⓈ-M Futures](https://developers.binance.com/docs/derivatives/usds-margined-futures/general-info)
+- On-chain tokens: [DEX Screener](https://dexscreener.com)
+- Prediction markets: [Polymarket Gamma API](https://docs.polymarket.com)
+
+Availability and fields vary by provider and market. Ticker Bar labels the provider on every quote.
+
+## Development
+
+```bash
+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.
+
+### Architecture
+
+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.
+
+### Repository layout
+
+```text
+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:
+
+```bash
+npm test
+npm run lint
+npm run build
+```
+
+## Troubleshooting
+
+- **A quote shows a warning:** open Market Details to see the last successful update and provider error, then run Update Market Data 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.
diff --git a/extensions/ticker-bar/assets/extension-icon.png b/extensions/ticker-bar/assets/extension-icon.png
diff --git a/extensions/ticker-bar/eslint.config.js b/extensions/ticker-bar/eslint.config.js
@@ -0,0 +1 @@
+module.exports = require("@raycast/eslint-config").flat();
diff --git a/extensions/ticker-bar/media/01-browse-markets.png b/extensions/ticker-bar/media/01-browse-markets.png
diff --git a/extensions/ticker-bar/media/02-manage-watchlist.png b/extensions/ticker-bar/media/02-manage-watchlist.png
diff --git a/extensions/ticker-bar/media/03-advanced-watchlist-editor.png b/extensions/ticker-bar/media/03-advanced-watchlist-editor.png
diff --git a/extensions/ticker-bar/media/04-menu-bar-dropdown.png b/extensions/ticker-bar/media/04-menu-bar-dropdown.png
diff --git a/extensions/ticker-bar/metadata/01-browse-markets.png b/extensions/ticker-bar/metadata/01-browse-markets.png
diff --git a/extensions/ticker-bar/metadata/02-manage-watchlist.png b/extensions/ticker-bar/metadata/02-manage-watchlist.png
diff --git a/extensions/ticker-bar/metadata/03-advanced-watchlist-editor.png b/extensions/ticker-bar/metadata/03-advanced-watchlist-editor.png
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		module.exports = require("@raycast/eslint-config").flat();