Files
stocks/README.md
2024-01-09 18:27:02 +01:00

78 lines
1.3 KiB
Markdown

# stocks.sh
> Real-time stock tickers from the command-line.
`stocks.sh` is a simple shell script using the Yahoo Finance API as a data source. It features colored output and is able to display pre- and post-market prices (denoted with `*`).
Based from [ticker.sh](https://github.com/pstadler/ticker.sh)
![stocks.sh](https://gitea.maboiteverte.fr/shell/stocks_mbv/raw/branch/master/screenshot.jpg)
## Install
```sh
$ curl -o ticker.sh https://raw.githubusercontent.com/pstadler/ticker.sh/master/ticker.sh
```
## Requirements
- [jq](https://stedolan.github.io/jq/), a versatile command-line JSON processor.
- [yq](https://github.com/mikefarah/yq/), a versatile command-line YAML processor.
## Usage
#### Preferences:
```bash
# Preference file:
$ nano ~/.stocks.yaml
watchlist:
- ^FCHI
- AC.PA
- ALCLS.PA
- ATO.PA
- AUB.PA
- CS.PA
- DG.PA
- ORA.PA
- VIRP.PA
- WLN.PA
lots:
- symbol: "AUB.PA"
quantity: 600
unit_cost: 32.164
- symbol: "ORA.PA"
quantity: 700
unit_cost: 9.426
```
#### Running:
```sh
# Single symbol:
$ ./ticker.sh AAPL
# Multiple symbols:
$ ./ticker.sh AAPL MSFT GOOG BTC-USD
# Run stocks.sh:
$ ./stocks.sh
# Update every five seconds:
$ watch -n 5 -t -c ./ticker.sh AAPL MSFT GOOG BTC-USD
# Or if `watch` is not available:
$ while true; do clear; ./ticker.sh; sleep 5; done
# Or
./run_stocks.sh
```