Setup guide

Set up Stock Price

Go from installation to a live market quote on your Stream Deck in a few minutes.

Step 1

Install the plugin

Install Stock Price from Elgato Marketplace, or download the .streamDeckPlugin file from the GitHub project.
If you downloaded the installer, double-click it and approve installation in the Stream Deck App.
In the actions list, find Stock Price and drag Stock Quote onto a key.

Step 2

Choose a market-data provider

The plugin supports Alpha Vantage and Finnhub. You only need one provider, although you can configure both and choose a different provider for each key.

Alpha Vantage

Simple REST quotes with daily change. Weekly history is fetched and cached separately.

Get an Alpha Vantage API key →

Finnhub

Live visible-price updates through one shared connection. Weekly change builds from locally saved history.

Get a Finnhub API key →

Step 3

Save the API key once

Select the Stock Quote key in the Stream Deck App.
Open Shared plugin settings in the property inspector.
Paste the API key for your chosen provider.
Keep the suggested request cap unless your provider plan permits a different limit, then save the shared settings.

One-time setup: provider credentials and safety limits are shared across every Stock Price key on this computer. Never post an API key in screenshots, support requests, or GitHub issues.

Step 4

Configure a stock key

Data provider: Select Alpha Vantage or Finnhub.
Ticker: Enter a provider-compatible symbol such as AAPL, MSFT, or TSLA.
Auto refresh: Choose the reference-quote interval or manual-only mode.
Daily and weekly change: Show or hide either change row.
Background: Choose market color, stock watermark, or a fixed custom color. Market mode supports separate up, down, and neutral colors.

Press the Stream Deck key whenever you want to request a manual refresh.

Free-tier-friendly defaults

Provider	Default protection	Weekly behavior
Alpha Vantage	24 requests per rolling 24 hours	Fetched at most once per symbol per day and cached
Finnhub	50 REST requests per rolling minute; reference refresh at least hourly	Calculated locally after about seven days of saved history

Status messages

Cached: The latest request failed, so the last successful quote is shown.
Set API key: The selected provider does not have a saved shared credential.
API limit: The configured safety cap or provider limit blocked the request.
W WAIT: Finnhub needs approximately seven days of local reference history.
W CAP / W ERR: The weekly request was capped or failed.
Check symbol: The provider did not recognize or return the ticker.

Still need help?

Visit the support page or report a reproducible issue. Include your operating system, Stream Deck version, provider, ticker, and visible status—but never your API key.

Open support GitHub Issues