sopel-stocks

A stock lookup plugin for Sopel IRC bots

Maintainer: @RustyBower

Installing

Releases are hosted on PyPI, so after installing Sopel, all you need is pip:

$ pip install sopel-stocks

Requirements

This release of sopel-stocks requires Python 3.8+ and Sopel 8.0 or higher.

You will need an API key from one of the following providers:

• Alpha Vantage
• Finnhub (recommended)
• IEX Cloud

Configuring

The easiest way to configure sopel-stocks is via Sopel's configuration wizard—simply run sopel-plugins configure stocks and enter the values for which it prompts you.

However, if you want or need to configure this plugin manually, you will need to define the following in ~/.sopel/default.cfg

[stocks]
api_key = API_KEY
provider = finnhub (or alphavantage/iexcloud)

Usage

.stock msft
<sopel> MSFT $123.37 1.6 (1.31%)⬆

.stock aapl amzn goog
<sopel> AAPL $150.83 -2.51 (-1.64%)⬇
<sopel> AMZN $97.06 -5.38 (-5.25%)⬇
<sopel> GOOG $90.445 -4.215 (-4.45%)⬇

Changelog

1.3.0

First release as sopel-stocks, replacing sopel_modules.stocks.

1.2.3

Added:

• Finnhub data provider

Fixed:

• Alpha Vantage API endpoint (yet again)

1.2.2

Changed:

• Further Alpha Vantage API updates

1.2.1

Fixed:

• Move away from premium Alpha Vantage endpoint

Meta:

• More packaging workflow updates

1.2.0

Added:

• Help message for .stock command
• Multi-symbol lookup

Meta:

• Project moved to Sopel's GitHub org, and docs/workflows updated

1.1.3

Fixed:

• Bug with newly IPO'd stocks

1.1.2

Fixed:

• Handling input of foreign ticker symbols

Meta:

• Additional installation documentation

1.1.1

Fixed:

• Presentation bug when using IEX Cloud data

Meta:

• Fixed packaging workflow

1.1.0

Added:

• IEX Cloud data provider
• New configuration to select data provider

1.0.4

Improved documentation and error handling

1.0.3

Fixed handling stocks with no prior history, i.e. new symbols

1.0.2

Fixed:

• Formatting for penny stocks

Meta:

• Additional packaging tweaks

1.0.1

Style/packaging fixes (no corresponding release)

1.0.0

Initial release of sopel_modules.stocks module, using Alpha Vantage for data.