1.0.4 • Published 3 years ago

tharz-stocks v1.0.4

Weekly downloads
6
License
ISC
Repository
github
Last release
3 years ago

Thar-stocks

thar-stocks is a terminal based application that provide stock price information.

How to use

$ curl https://terminal-stocks.herokuapp.com/<TICKER>

Example

$ curl https://terminal-stocks.herokuapp.com/ITC.NS

Note

  • This app uses the yahoo finance to fetch information. Please provide ticker for yahoo finance.

CLI Usage

You can use the terminal-stocks command line interface (cli)

  • install cli globaly
npm i terminal-stocks -g
  • run the commands to get informations
Available commands
terminal-stocks --help // to get help
terminal-stocks --version  // to see the version
terminal-stocks -t [ticker] // to see current price information of the stock
terminal-stocks --ticker [ticker] // to see current price information of the stock
terminal-stocks -t [ticker] --historical [domain] // to see the historical price information of stock
terminal-stocks -m // to see the market summary
terminal-stocks --market // to see the market summary

Example

terminal-stocks -t ITC.NS

View Historical data

Example

$ curl https://terminal-stocks.herokuapp.com/historical/ITC.NS
  • By default it shows 10 entries. This api is paginated so you can use ?page=2 to view next entries.

View Market Summary

Example

$ curl https://terminal-stocks.herokuapp.com/market-summary

Tech

Installation

Requires Node.js v8+ to run. Install the dependencies and devDependencies and start the server.

$ git clone "https://github.com/shweshi/terminal-stocks"
$ npm install
$ npm run serve

Development

Want to contribute? Great! Feel free to open a PR.

Happy Coding!!!