You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
51 lines
1.1 KiB
51 lines
1.1 KiB
6 months ago
|
---
|
||
|
|
title: Stocks
|
||
|
|
description: Stocks Service Widget Configuration
|
||
|
|
---
|
||
|
|
|
||
|
|
_(Find the Stocks information widget [here](../info/stocks.md))_
|
||
|
|
|
||
|
|
The widget includes:
|
||
|
|
|
||
|
|
- US stock market status
|
||
|
|
- Current price of provided stock symbol
|
||
|
|
- Change in price of stock symbol for the day.
|
||
|
|
|
||
|
|
Finnhub.io is currently the only supported provider for the stocks widget.
|
||
|
|
You can sign up for a free api key at [finnhub.io](https://finnhub.io).
|
||
|
|
You are encouraged to read finnhub.io's
|
||
|
|
[terms of service/privacy policy](https://finnhub.io/terms-of-service) before
|
||
|
|
signing up.
|
||
|
|
|
||
|
|
Allowed fields: no configurable fields for this widget.
|
||
|
|
|
||
|
|
You must set `finnhub` as a provider in your `settings.yaml`:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
providers:
|
||
|
|
finnhub: yourfinnhubapikeyhere
|
||
|
|
```
|
||
|
|
|
||
|
|
Next, configure the stocks widget in your `services.yaml`:
|
||
|
|
|
||
|
|
The service widget allows for up to 28 items in the watchlist. You may get rate
|
||
|
|
limited if using the information and service widgets together.
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
widget:
|
||
|
|
type: stocks
|
||
|
|
provider: finnhub
|
||
|
|
showUSMarketStatus: true # optional, defaults to true
|
||
|
|
watchlist:
|
||
|
|
- GME
|
||
|
|
- AMC
|
||
|
|
- NVDA
|
||
|
|
- TSM
|
||
|
|
- BRK.A
|
||
|
|
- TSLA
|
||
|
|
- AAPL
|
||
|
|
- MSFT
|
||
|
|
- AMZN
|
||
|
|
- BRK.B
|
||
|
|
```
|