JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 68
  • Score
    100M100P100Q71744F
  • License ISC

Algorithmically trade stocks and options using Robinhood, Yahoo Finance, and more.

Package Exports

  • algotrader

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (algotrader) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Algotrader

Simple algorithmic stock trading for Node.js.

npm package

NPM Version NPM Downloads GitHub Commit GitHub Issues Discord

Features

  • Extensive broker library
    • Easily place orders
    • Retrieve past orders
    • Query a users portfolio
    • Supported brokers:
      • Robinhood
      • TDAmeritrade (in progress)
      • Oanda (in progress)
      • If you'd like to have another broker supported, submit an issue or a pull request
  • Data library
    • Real time quote data streaming for cryptocurrency, forex, equities
      • Get data on bids, asks, last price, and more from the Yahoo Finance API
      • Stream news headlines along with quotes
    • Up-to-date options data
    • Easily find stocks for various queries
      • Retrieve the day's top gainers
      • Retrieve the day's top losers
      • Get stocks by highest (abnormal) volume
      • Get options contracts by highest open interest
      • And more
    • Get up to the minute breaking headlines
    • Get technical indicators from AlphaVantage
      • SMA, EMA, RSI, etc.
    • Get fundamentals and balance sheet data (in progress)
      • Assets, debt, liabilities, revenue, earnings, etc.
  • Algorithm library (in progress)
    • Create algorithms that will automatically place trades based on your criteria
    • Backtest algorithms on past market data
    • Paper (simulated) trade your algorithm to see how it performs in real time
  • Support for many third-party APIs

Table of Contents

Getting started

Using NPM, you can install Algotrader using the following console command: npm i algotrader --save

Once Algotrader is installed, you can import it into your Node.js project.

const algotrader = require('algotrader');

After, you can instantiate any Algotrader library like so:

const Robinhood = algotrader.Robinhood;
const Data = algotrader.Data;
const Algorithm = algotrader.Algorithm; // in progress

Robinhood

First, you'll need to create a new User instance and authenticate them.

const robinhood = require('algotrader').Robinhood;
const User = robinhood.User;

const myUser = new User("username", "password");
myUser.authenticate()
    .then(() => {
        // User was authenticated
    })
    .catch(error => {
        // Either the request failed, or Robinhood responded with an error.
        // (Ex: you don't have internet access or your user credentials were incorrect)
    })

Personally, I either store user data as an array in a .json file, then require it into the class, (insecure) or ask for the user's credentials in the console. You should handle this sensitive data in a way that you're comfortable with.

Get a user's portfolio

There are a good amount of query functions that you can run on the user's portfolio. Using your User instance, you can grab the portfolio using User.getPortfolio() which returns a new Portfolio object.

myUser.getPortfolio()
    .then(myPortfolio => { // Algotrader retrieved the user's portfolio
        // You can find information on specific symbols
        let myTeslaShares = myPortfolio.getQuantity("TSLA"); // Returns the quantity of shares you own in the given symbol: 10
        let bestDayEver = myPortfolio.getPurchaseDate("SHLD"); // Returns the date (Date object) you purchased the given symbol: 2007-04-17
        // You can find information on the entire portfolio
        let mySymbols = myPortfolio.getSymbols(); // Returns an array of all symbols in the user's portfolio: ['FB', 'AMZN', 'NFLX', 'GOOG']
        let myMoneyMakers = myPortfolio.getQuantityGreaterThan(50); // Returns an array of all positions greater than the given amount: [Object]
        // Along with much more. See the link below to visit the Robinhood portfolio documentation.
    })
    .catch(error => {
        // Either the request failed, or Robinhood responded with an error.
        // (Ex: you don't have internet access or your user credentials were incorrect)
    })

For documentation on all portfolio functions, visit the Robinhood Library Docs.

Placing an order

Placing an order will require instances of the User, Instrument, Quote, and Order classes.

All orders first require that you grab a new Instrument object which represents, in most cases, a stock or ETF. You can also grab the object from your Portfolio. Then, Robinhood requires that you also submit the stock's market price in the order, so you should retrieve a Quote from them on via Instrument object (the origin of the quote doesn't matter, as long as it contains accurate pricing information- so, the quote returned from the Stream class would also work). You'll then create an object with this and other necessary information to pass as a parameter to a new Order.

The object should contain the following:

  • Instrument - The Robinhood instrument you would like to place an order for.
  • Quote - An updated quote containing the last sale price for the given instrument.
  • type
    • limit - The lowest price to accept in a buy, the highest price in a sell
    • market - Order executes at the current bid/ask price
  • timeInForce
    • GFD - Good for the day (cancels at market close)
    • GTC - Good-til-cancelled (active until you cancel it)
    • IOC - Immediate or cancel (possibly deprecated by Robinhood)
    • OPG - Market/limit on open (possibly deprecated by Robinhood)
  • trigger
    • immediate - The order is active as soon as it's placed
    • stop - The order won't be active until the market price crossed your stop price
  • stopPrice
    • If trigger = stop, this must be specified
  • quantity
    • How many shares should be bought / sold
  • side
    • buy
    • sell
  • extendedHours
    • boolean - Whether the order should be allowed to execute when exchanges are closed
  • overrideDayTradeCheck
    • boolean - Whether to override Pattern Day Trader protection (this should definitely be false)

With this in mind, you can place a simple market order for ten shares of Twitter like so:

// ES6
Instrument.getBySymbol("TWTR").then(async twtrInstrument => {
    let twtrQuote = await twtrInstrument.getQuote();
    const myOrder = new Order(user, {
        instrument: twtrInstrument,
        quote: twtrQuote,
        type: "market",
        timeInForce: "gfd",
        trigger: "immediate",
        quantity: 10,
        side: "buy"
    });
    myOrder.submit().then(res => {
        // Order was successful
    }).catch(error => {
        // Either the request failed, or Robinhood responded with an error.
        // (Ex: you don't have internet access or your balance was insufficient)
    });
});

For documentation on all order functions, visit the Robinhood Library Docs.

Algorithm Library

For scheduling tasks, running backtests, and paper-trading, the algorithm library should be more than useful.

Scheduler

Using the Scheduler class, you'll be able to define exactly when you want a function to run using the following methods:

  • Scheduler.onMarketOpen(offset, f)
    • Runs every morning when the NYSE opens. (Typically 9:30 AM EST)
    • Offset is in milliseconds and can be positive (after) or negative (before).
  • Scheduler.onMarketClose(offset, f)
    • Runs every afternoon when the NYSE closes. (Typically 4:00 PM EST)
    • Offset is in milliseconds and can be positive (after) or negative (before).
  • Scheduler.every(minutes, extended, f)
    • Runs every x minutes during market hours or during typical extended trading hours. (9 AM EST - 6 PM EST)

Here's an easy example that runs a function 5 minutes before the market opens and another one every 30 minutes during regular trading hours:

const Scheduler = algotrader.Algorithm.Scheduler;

Scheduler.onMarketOpen(-5 * 60000, () => {
    // Function to run five minutes before the market opens
});

Scheduler.every(30, false, () => {
    // Function to run every 1/2 hour
});

For documentation on all Scheduler functions, visit the Algorithm Library Docs.

Data Library

The data library allows you to retrieve a ton of data on the market as a whole and individual stocks or options. This uses the Yahoo Finance and Alpha Vantage APIs and additional support for other free API's will be added in the future.

I'll only add a few examples here, but for the full documentation visit the Data Library Docs.

Real time streaming

To stream live quotes from Yahoo Finance, you'll need an array of symbols that you want to monitor. If you only need data on one, just fill the array with that single symbol. The Stream class is an extension of the Node EventEmitter, so you can either use .on() or .pipe() like other events.

Once the stream starts, a data object for each symbol is immediately received. You will then begin to get real time updates. Note that the data objects streamed by Yahoo aren't always of the same format, so make sure to have a check for undefined each time you access a key in the object.

const Stream = algotrader.Data.Stream;

const myStream = new Stream(["PG", "DPS", "ULTA", "DIN", "ETSY"]);
myStream.start();

myStream
    .on('quote', quote => {
        // Returns a single Quote object. See the link below for documentation on Quotes.
    })
    .on('response', res => {
        // Returns a response object from the request module. Useful for debugging.
    })
    .on('error', error => {
        // Returns an error if the stream failed to start.
    });

For documentation on Quotes, visit the Global Docs.

Not only can you stream quotes, but you can include news articles using the built-in News Library. This is useful for reacting to breaking headlines with pre-determined trades (for example, earnings reports or FOMC results). To do this, just add a second parameter (an object) to new Stream() as shown below.

const myStreamWithNews = new Stream(["JPM", "COST", "FDX"], {
    news: true, // Tells the streamer to also include news
    allHeadlines: true, // If true, all U.S. headlines will be sent in the stream. If false, only news pertaining to the given symbols will be outputted.
    newsApiKey: "newsApiKeyGoesHere" // Your API key from NewsAPI.org. See the link below for documentation on News.
});
myStreamWithNews.start();

myStreamWithNews
    .on('quote', quote => {
        // Returns a single Quote object. See the link below for documentation on Quotes.
    })
    .on('news', news => {
        // Returns a single News object. See the link below for documentation on News.
    })
    .on('response', res => {
        // Returns a response object from the request module. Useful for debugging.
    })
    .on('error', error => {
        // Returns an error if the stream failed to start.
    });

For documentation on News, visit the Data Library Docs.

Alpha Vantage

Providing free access to real time and historical market data along with advanced technical analysis, Alpha Vantage has proven to be very helpful when it comes to analyzing stock activity. The only caveat is that, during market hours, their servers can occasionally take a while to respond. But aside from that, you won't find a more well equipped API for free.

To use Algotrader's built-in Alpha Vantage library, you'll first need to grab a free API key here. After the key is displayed on the page, you can copy it to your program and instantiate a new AlphaVantage object like so:

const AlphaVantage = algotrader.Data.AlphaVantage;
const av = new AlphaVantage("myApiKey");

After, you can access any of the information provided in their documentation easily.

// Get real time intraday price information
av.timeSeriesIntraday("AAPL", "1min").then(array => {
    // Returns an array of Quote objects for every minute since market open
    array.forEach(quote => {
        console.log( quote.getOpen() );   // 174.78
        console.log( quote.getVolume() ); // 13523
    });
});
// Get relative strength index
av.rsi("AAPL", "daily", 14, "close").then(array => {
    // Returns an array of objects representing the RSI on each day
    array.forEach(rsi => {
        // { date: 2017-11-17T00:00:00.000Z, RSI: '57.3707' }
    });
});

For documentation on all Alpha Vantage functions, visit the Data Library Docs.

Query

Using the Yahoo Finance and Robinhood APIs, you can easily find stocks based on certain criteria.

Here are a few examples:

const Query = algotrader.Data.Query;

Query.getEarnings(1).then(array => {
    // Returns an array of companies that are reporting their earnings within the next '1' day.
    // [
    //     { 
    //      symbol: 'NFLX',
    // 	    instrument: 'https://api.robinhood.com/instruments/81733743-965a-4d93-b87a-6973cb9efd34/',
    //      year: 2018,
    //      quarter: 1,
    //      eps: { estimate: '0.6400', actual: null },
    //      report: { date: '2018-04-16', timing: 'pm', verified: true },
    //      call:
    //          { datetime: '2018-04-16T22:00:00Z',
    //            broadcast_url: 'http://mmm.wallstreethorizon.com/u.asp?u=152320',
    //            replay_url: null }
    //     },
    // ... and more
});

Query.search("Nordstrom").then(array => {
    // Returns an array of matching stocks, options, ETF's, and others.
    // [
    // 	{ symbol: 'JWN',
    // 		name: 'Nordstrom, Inc.',
    // 		exch: 'NYQ',
    // 		type: 'S',
    // 		exchDisp: 'NYSE',
    // 		typeDisp: 'Equity' },
    // 	{ symbol: 'JWN180420C00045000',
    // 		name: 'JWN Apr 2018 call 45.000',
    // 		exch: 'OPR',
    // 		type: 'O',
    // 		exchDisp: 'OPR',
    // 		typeDisp: 'Option' },
    //  ... and more
});

Query.getTopGainers(5).then(array => {
    // Returns an array of objects each containing information on the five best performing stocks.
    // You can also use .getTopLosers(count)
});

Query.getHighestVolume(5).then(array => {
    // Returns an array of objects each containing information on five of today's stocks with the highest volume.
});

For documentation on all functions of the Query class, visit the Data Library Docs.

News

Thanks to both News API and Yahoo Finance, you can get breaking news headlines and various articles on either specific companies or the market or world as a whole.

First you'll want to create a reference to the News class: const News = algotrader.Data.News;

You can then use either Yahoo Finance or News API to retrieve news articles, but it's easier to find exactly what you're looking for with the latter.

For Yahoo Finance, simply do the following:

News.getFromYahoo("AAPL").then(array => {
    // Returns an array of news articles for the given symbol
    // [
    // 	    News {
    // 		    title: 'Amazon and Walmart Battle for Control of Flipkart',
    // 		    description: 'The world's largest retailer and its online counterpart compete on many fronts, but the fight for India's largest online retailer may be one of the most important.',
    // 		    date: 2018-04-15T15:45:00.000Z,
    // 		    source: undefined,
    // 		    author: undefined,
    // 		    url: 'https://finance.yahoo.com/news/amazon-walmart-battle-control-flipkart-154500760.html?.tsrc=rss' },
    // 	    News {
    // 		    title: 'President Trump is considering rejoining the Trans Pacific Partnership trade deal',
    // 		    	description: 'President Trump is opening the door to rejoining the Trans Pacific Partnership trade deal. Yahoo Finance’s Jen Rogers and Rick Newman look at the implications.',
    // 		    	date: 2018-04-13T14:40:56.000Z,
    // 		    	source: undefined,
    // 		    	author: undefined,
    // 		    	url: 'https://finance.yahoo.com/video/president-trump-considering-rejoining-trans-144056381.html?.tsrc=rss' },
    // ... and more
});

You'll notice that Yahoo Finance does not provide the author or the source and only links back to their website.

With News API, you'll get many more options on what articles to return. However, you'll need a free API key in order to use their service. Register for one here. You can then get either breaking/recent headlines or search for all articles matching your query.

Each News API query must contain an object with at least one query option. Possible parameters for the two functions are:

  • getHeadlines(apiKey, object)
    • q - Keywords or phrases to search for.
    • category - Possible options: business, entertainment, general, health, science, sports, technology (Cannot be mixed with sources parameter)
    • country- The 2-letter ISO 3166-1 code of the country you want to get headlines for. (Cannot be mixed with sources parameter)
    • sources - A comma-separated string of identifiers (maximum 20) for the news sources or blogs you want headlines from. (Cannot be mixed with country parameter)
    • pageSize - The number of results to return per page. 20 is the default, 100 is the maximum.
    • page - Use this to page through the results.
  • getAll(apiKey, object)
    • q - Keywords or phrases to search for.
    • sources - A comma-separated string of identifiers (maximum 20) for the news sources or blogs you want headlines from.
    • domains - A comma-separated string of domains (eg bbc.co.uk, techcrunch.com, engadget.com) to restrict the search to.
    • from - A date object for the oldest allowed article.
    • to - A date object for the newest allowed article.
    • language - Possible options: ar, de, en, es, fr, he, it, nl, no, pt, ru, se, ud, zh
    • sortBy - Possible options: relevancy, popularity, publishedAt (newest)
    • pageSize - The number of results to return per page. 20 is the default, 100 is the maximum.
    • page - Use this to page through the results.

Here is an example query for U.S. articles relating to using getHeadlines(apiKey, object):

News.getHeadlines("myApiKey", {
    country: "us",
    category: "business"
}).then(array => {
    // Returns an array of News objects related to U.S. business.
    // [
    //      News {
    //              title: 'Two black men were arrested waiting at a Starbucks. Now the company, police are on the defensive.',
    //              description: 'The backlash is a dramatic turn from efforts to craft the company as a progressive 	corporate leader that values “diversity and inclusion.”',
    //              date: 2018-04-15T15:22:22.000Z,
    //              source: 'The Washington Post',
    //              author: null,
    //              url: 'https://www.washingtonpost.com/news/business/wp/2018/04/15/two-black-men-were-arrested-waiting-at-a-starbucks-now-the-company-police-are-on-the-defensive/' },
    //      News {
    //              title: 'Zillow surprises investors by buying up homes',
    //              description: 'Real estate platform Zillow changed up its business model this week, announcing that it plans to purchase and sell homes in Las Vegas and Phoenix. Zillow will be working with Berkshire Hathaway and Coldwell Banker to make offers on homes before it finds a buy…',
    //              date: 2018-04-15T00:27:56.000Z,
    //              source: 'TechCrunch',
    //              author: 'Katie Roof',
    //              url: 'https://techcrunch.com/2018/04/14/zillow-surprises-investors-by-buying-up-homes/' }
    // ... and more
});

The News Class provides a few functions that you can run to easily retrieve information you need, such as news.getTitle(), news.getDate(), and news.getDescription(). You can also download the full article from the source:

news.getArticle().then(html => {
    // This will return raw HTML from the source. You'll have to parse it yourself if you want to read the entire article, but typically the description - news.getDescription() - is sufficient.
});

For documentation on all News functions, visit the Data Library Docs.