# 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
```