An open API service indexing awesome lists of open source software.

https://github.com/aranair/rtscli

Python CLI Stocks Ticker + Portfolio Tracker
https://github.com/aranair/rtscli

cli python realtime stock-ticker stocks terminal urwid

Last synced: 5 months ago
JSON representation

Python CLI Stocks Ticker + Portfolio Tracker

Awesome Lists containing this project

README

          

## rtscli - Realtime Stock Ticker CLI

- A stock ticker that runs in console
- It grabs info from Google Finance Api every 10 seconds, or if you press R
- It's pretty simple but if you wanna read through a blog post instead: https://aranair.github.io/posts/2017/06/28/building-a-python-cli-stock-ticker-with-urwid/

**NOTE!!**
This has been changed to use https://www.alphavantage.co because Google Finance does not seem to work reliably anymore (IPs get blocked and it just plain out doesn't work)

You can get a free API key with a limited number of queries per second and so this has been tweaked to just refresh every 60s now. Put the api-key into `alphavantage-creds.txt` and it should work as usual.

## Screenshot

![Demo](https://github.com/aranair/rtscli/blob/master/rtscli-demo.png?raw=true "Demo")

## Dependencies

Currently this is dependent on the list below but the next step is to build this into an executable so
all that stuff with python and pip can be skipped.

- Python2.7
- pip
- Bunch of other python packages

## Install via Pip

```
pip install rtscli
```

## Running it

```bash
$ cp tickers.txt.sample tickers.txt
$ rtscli
```

## Tickers.txt Sample

Format: Name, Ticker(Alphavantage format), cost price, shares held

```
GLD,GLD,139,1
```

## Downloading and building manually

```
$ git clone git@github.com:aranair/rtscli.git
$ pip install -e .
$ rtscli
```
## Future Developments

Not sure if this is of interest to anyone but if you'll like to see anything on this, raise an issue or something.

## License

MIT