stockfinder

Stock Finder

A fast way to query IEX Cloud to find recent stock data.
Explore the docs »

View Demo · Stock-Finder Bug · Request Feature

Table of Contents

• About the Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
• License
• Contact

About The Project

I created this project to easily query the IEX Cloud database of stock information for my own use. I originally started by looking for packages that already offered this and there was none that was updated. I then created this package to allow for a much more streamlined approach to do this.

Built With

• NPM
• NodeFetch
• TypeScript

Getting Started

To get started with using this package follow these steps.

Prerequisites

You need to have the latest version of NPM for this project to work.

• npm

npm install npm@latest -g

Installation

1. Clone the Stock-Finder

git clone https://github.com/austinmccalley/Stock-Finder.git

2. Install NPM packages

npm install

3. Build JS File

tsc

Usage

Here is a code sample of how to do a simple request for $TSLA stock information using the package with the getStock() function.

const stockFinder = require('stockfinder');

/*
  Declare the Stock Finder with
  the parameters you want
*/
const sf = new stockFinder('stable', 'TSLA', apiKey, false);

/*
  Call the get stock function and then wait
  for the promise to return
*/
sf.getStock().then(res => {
  console.log(res)
});

If you want to get multiple stocks you will use the getStocks() function.

const stockFinder = require('stockfinder');

/*
  Declare the Stock Finder with
  the parameters you want
*/
const sf = new stockFinder('stable', ['TSLA','AAPL'], apiKey, false);

/*
  Call the get stocks function and then wait
  for the promise to return
*/
sf.getStocks().then(res => {
  console.log(res)
});

Note

Sometimes IEX Cloud has issues with normal requests, you can switch to using a CURL request instead by following the example.

const stockFinder = require('stockfinder');

/*
  Declare the Stock Finder with
  the parameters you want
*/
const sf = new stockFinder('stable', 'TSLA', apiKey, true);

/*
  Call the get stock function and then wait
  for the promise to return
*/
sf.getStock().then(res => {
  console.log(res)
});

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Austin McCalley - [e-mail]

Project Link: https://github.com/austinmccalley/Stock-Finder