FAQ

Home > FAQs > The stocks blank

What is the stocks blank in OpenCues?

Type nvda _ and the _ becomes NVDA: $198.47. The stocks blank fetches a live quote from Finnhub for a small dictionary of popular tickers and company names, straight into whatever you're writing.

What you type

The shipped keyword list covers the most-asked names in three spellings each: the ticker (nvda, aapl, tsla), the company (nvidia, apple, tesla), and the explicit form (nvidia stock). Reddit, Google, Microsoft, and Amazon are covered the same way; Meta gets two forms, since its ticker doubles as its name. The keyword must lead the sentence your _ ends; a mid-sentence mention never fires.

Where the data comes from

Finnhub's quote API. It needs a FINNHUB_API_KEY, which is free to obtain; store it with opencues set-key finnhub <key>. Without a key the blank doesn't register at all, so a missing key shows up as the blank simply not firing rather than as a cryptic error. Quotes are cached for one minute per ticker.

Read-only, self-contained output

Cycling is a no-op by design: a share price isn't a value you step through, so the blank declares itself read-only. The answer embeds the ticker (NVDA: $198.47) so it stays meaningful after the command span clears. If Finnhub returns an error you see it in place (NVDA: HTTP 429), never a silent gap.

Two details worth knowing: unknown keywords are treated as ticker symbols directly (the input is sanitised to valid symbol characters first), so extending coverage is possible without code; and when the optional blank-context-mode is on, five popular tickers are exposed as ambient tokens so phrasings like how are my stocks doing _ can route through the catalog.

Related: The crypto blank · What is a blank? · Write your own blank · Check stocks while typing · GitHub repo