You've successfully subscribed to Alpaca Learn | Developer-First API for Crypto and Stocks
Great! Next, complete checkout for full access to Alpaca Learn | Developer-First API for Crypto and Stocks
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.
Success! Your billing info is updated.
Billing info update failed.
Search
Algorithmic Trading Basics

Long-Short Algorithmic Trading in JavaScript (Node.js) Using Stock API

Alpaca Team
Alpaca Team

In this post, I will be sharing how I created a simple Long-Short Equity trading script in JavaScript (a Node.js app) using Alpaca’s free paper trading API. Full code sample is here on GitHub.

alpacahq/alpaca-trade-api-js
Contribute to alpacahq/alpaca-trade-api-js development by creating an account on GitHub.

Alpaca’s paper trading API simulates the live trading API in a paper environment so we don’t have to worry about trading with real money when testing a strategy.

To get access to the paper trading API, sign up here. Once you’ve signed up, you should now have access to the Alpaca paper trading dashboard, which allows you to monitor your paper trading and gives you the access keys to link your script to your account.

The Strategy

The example strategy I will be implementing in this script is the Long-Short equity strategy. The idea behind this strategy is to rank a group of stocks from better performing to worse performing stocks, then to long the top stocks in the list and short the bottom ones. By doing this, the algorithm takes maximizes potential gains by longing what it predicts are going to be the better performing stocks, and shorting the predicted worse performing stocks.

The driving force behind success, though, is how the stocks are ranked. The ranking can make or break your algorithm. If your ranking system is good, ideally you’ll be longing stocks that are green the following days and shorting ones that aren’t doing so well. However, a bad ranking system could see your algorithm longing poorly performing stocks and, perhaps more dangerously, shorting high performing stocks, which could cause your algorithm to quickly lose you money.

Getting Started

If you already know how to set up a Node.js environment and run Node.js apps, you can skip this section. If not, this section will detail how to set up a Node.js environment for running the Long-Short script.

First, you need to download Node.js from the internet and run the installer. You can download it here. Once Node.js is finished downloading, create a new folder and run following command while in the folder:

 npm init && npm install

Once you run this command, you’ll be presented with options while in the terminal. You can just hit enter through all the options. After completing all of the options, your Node.js application will be initialized.

To run this particular script, you will also need to install the Alpaca node module, which can be found in the Alpaca JavaScript SDK. To install, you just run the command:

 npm install --save @alpacahq/alpaca-trade-api 

while in your Node.js directory, and the Alpaca node module should install.

Once you’ve completed all these steps, all you need to do is download the long-short.js file (found in the Alpaca JavaScript SDK, under the “examples” folder) and place it in the folder (making sure to input your API keys into the script). Now you just run the command node long-short while in the folder, and the script should start running. You can stop the script anytime using the command Ctrl+C in the command line.

Overview

Before we dive into the code, I’ll give a high-level overview of this script. Here’s an outline:

  1. The script checks if the market is open. If not, the script spins for a minute and does nothing. If open, the script begins to run.
  2. Rebalance the portfolio every minute by getting a list of stocks to long and short, and then executing those orders based on amount of equity allocated to each bucket.
  3. When the time is within 15 minutes of market close, the script clears all positions and sleeps until the market is closed.
  4. After the market is closed, the script awakes and begins checking if the market is open, effectively looping back to step 1.

And that’s it! Now that we have a decent, high-level understanding, we can dive into the code so that you can fully understand what’s going on. This way, you will be able to make changes along the way so that you can customize the script to fit your needs.

PS: If you find yourself not understanding the code well enough to make changes after the walk-through, don’t worry. The last section of this article will explicitly show you some simple customizations you can make without needing to understand the code.

The Code

I’ll walk you through each major component of the script. First, I have input constants so that I can link my account to the script. To get your keys, hit the “Generate Keys” on your Alpaca paper trading dashboard and copy and paste them here:

const API_KEY = 'YOUR_API_KEY_HERE';
const API_SECRET = 'YOUR_API_SECRET_HERE';
const PAPER = true;

Next, I initialized a class which will contain all methods that the script will use. In the class initializer, the script initially establishes a connection to the Alpaca API, and initializes a bunch of class variables that will be used throughout the script. You can customize the stocks that you want to rank in the this.allStocks array, making sure to keep the formatting as a string array of stock symbols. The list of stocks below is an example and is for illustrative purposes only.

class LongShort {
  constructor(API_KEY, API_SECRET, PAPER){
    this.Alpaca = require('@alpacahq/alpaca-trade-api');
    this.alpaca = new this.Alpaca({
      keyId: API_KEY, 
      secretKey: API_SECRET, 
      paper: PAPER
    });

    this.allStocks = ['DOMO', 'TLRY', 'SQ', 'MRO', 'AAPL', 'GM', 'SNAP', 'SHOP', 'SPLK', 'BA', 'AMZN', 'SUI', 'SUN', 'TSLA', 'CGC', 'SPWR', 'NIO', 'CAT', 'MSFT', 'PANW', 'OKTA', 'TWTR', 'TM', 'RTN', 'ATVI', 'GS', 'BAC', 'MS', 'TWLO', 'QCOM'];
    // Format the allStocks variable for use in the class.
    var temp = [];
    this.allStocks.forEach((stockName) => {
      temp.push({name: stockName, pc: 0});
    });
    this.allStocks = temp.slice();

    this.long = [];
    this.short = [];
    this.qShort = null;
    this.qLong = null;
    this.adjustedQLong = null;
    this.adjustedQShort = null;
    this.blacklist = new Set();
    this.longAmount = 0;
    this.shortAmount = 0;
    this.timeToClose = null;
  }
}

// Run the LongShort class
var ls = new LongShort(API_KEY, API_SECRET, PAPER);
ls.run();

The function run() will be the main method of this algorithm. First, it clears all incomplete orders so that none of them fill while rebalancing the portfolio, which would interfere with the rebalancing. Next, it waits until the market opens by awaiting a promise from awaitMarketOpen(), which will only resolve when the market is open. Finally, there’s the trading portion of the script (handled mainly by the function rebalance()), which executes after every minute until 15 minutes before market close, where it then closes all positions and sleeps until the market is closed, where it then calls run() again and starts the cycle all over again.

async run(){
  // First, cancel any existing orders so they don't impact our buying power.
  var orders;
  await this.alpaca.getOrders({
    status: 'open', 
    direction: 'desc' 
  }).then((resp) => {
    orders = resp;
  }).catch((err) => {console.log(err.error);});
  var promOrders = [];
  orders.forEach((order) => {
    promOrders.push(new Promise(async (resolve, reject) => {
      await this.alpaca.cancelOrder(order.id).catch((err) => {console.log(err.error);});
      resolve();
    }));
  });
  await Promise.all(promOrders);

  // Wait for market to open.
  console.log("Waiting for market to open...");
  var promMarket = this.awaitMarketOpen();
  await promMarket;
  console.log("Market opened.");

  // Rebalance the portfolio every minute, making necessary trades.
  var spin = setInterval(async () => {

    // Figure out when the market will close so we can prepare to sell beforehand.
    await this.alpaca.getClock().then((resp) =>{
      var closingTime = new Date(resp.next_close.substring(0, resp.next_close.length - 6));
      var currTime = new Date(resp.timestamp.substring(0, resp.timestamp.length - 6));
      this.timeToClose = Math.abs(closingTime - currTime);
    }).catch((err) => {console.log(err.error);});

    if(this.timeToClose < (60000 * 15)) {
      // Close all positions when 15 minutes til market close.
      console.log("Market closing soon.  Closing positions.");

      await this.alpaca.getPositions().then(async (resp) => {
        var promClose = [];
        resp.forEach((position) => {
          promClose.push(new Promise(async (resolve, reject) => {
            var orderSide;
            if(position.side == 'long') orderSide = 'sell';
            else orderSide = 'buy';
            var quantity = Math.abs(position.qty);
            await this.submitOrder(quantity, position.symbol, orderSide);
            resolve();
          }));
        });

        await Promise.all(promClose);
      }).catch((err) => {console.log(err.error);});
      clearInterval(spin);
      console.log("Sleeping until market close (15 minutes).");
      setTimeout(() => {
        // Run script again after market close for next trading day.
        this.run();
      }, 60000*15);
    }
    else {
      // Rebalance the portfolio.
      await this.rebalance();
    }
  }, 60000);
}

// Spin until the market is open
awaitMarketOpen(){
  var prom = new Promise(async (resolve, reject) => {
    var isOpen = false;
    await this.alpaca.getClock().then(async (resp) => {
      if(resp.is_open) {
        resolve();
      }
      else {
        var marketChecker = setInterval(async () => {
          await this.alpaca.getClock().then((resp) => {
            isOpen = resp.is_open;
            if(isOpen) {
              clearInterval(marketChecker);
              resolve();
            } 
            else {
              var openTime = new Date(resp.next_open.substring(0, resp.next_close.length - 6));
              var currTime = new Date(resp.timestamp.substring(0, resp.timestamp.length - 6));
              this.timeToClose = Math.floor((openTime - currTime) / 1000 / 60);
              console.log(this.timeToClose + " minutes til next market open.")
            }
          }).catch((err) => {console.log(err.error);});
        }, 60000);
      }
    });
  });
  return prom;
}

// Submit an order if quantity is above 0.
async submitOrder(quantity,stock,side){
  var prom = new Promise(async (resolve,reject) => {
    if(quantity > 0){
      await this.alpaca.createOrder({
        symbol: stock,
        qty: quantity,
        side: side,
        type: 'market',
        time_in_force: 'day',
      }).then(() => {
        console.log("Market order of | " + quantity + " " + stock + " " + side + " | completed.");
        resolve(true);
      }).catch((err) => {
        console.log("Order of | " + quantity + " " + stock + " " + side + " | did not go through.");
        resolve(false);
      });
    }
    else {
      console.log("Quantity is <=0, order of | " + quantity + " " + stock + " " + side + " | not sent.");
      resolve(true);
    }
  });
  return prom;
}

The function rebalance() is where all the trading happens. It first calls the function rerank(), which ranks the stocks from last to first, and then assigns them to either the long or short (or nothing) bucket, and determines the quantity that should be shorted for each bucket. The ranking mechanism itself is handled by rank(). After calling rerank(), rebalance() will adjust any positions that I have with the new quantities (either ordering a corrective amount or clearing the position if the stock is no longer in either list). After clearing positions, the script then market orders all the new stocks with the respective quantities using sendBatchOrder(). sendBatchOrder() is special because it’ll return the stocks that succeeded to order, and stocks that failed to order. After receiving which stocks orders failed, rebalance() reorders more of the stocks that executed successfully using the leftover equity that would’ve been used for stock orders that failed. Once the stocks are reordered, the trading will end, and the script will wait a minute to trade again.

// Rebalance our position after an update.
async rebalance(){
  await this.rerank();

  // Clear existing orders again.
  var orders;
  await this.alpaca.getOrders({
    status: 'open', 
    direction: 'desc'
  }).then((resp) => {
    orders = resp;
  }).catch((err) => {console.log(err.error);});
  var promOrders = [];
  orders.forEach((order) => {
    promOrders.push(new Promise(async (resolve, reject) => {
      await this.alpaca.cancelOrder(order.id).catch((err) => {console.log(err.error);});
      resolve();
    }));
  });
  await Promise.all(promOrders);


  console.log("We are taking a long position in: " + this.long.toString());
  console.log("We are taking a short position in: " + this.short.toString());
  // Remove positions that are no longer in the short or long list, and make a list of positions that do not need to change.  Adjust position quantities if needed.
  var positions;
  await this.alpaca.getPositions().then((resp) => {
    positions = resp;
  }).catch((err) => {console.log(err.error);});
  var promPositions = [];
  var executed = {long:[], short:[]};
  var side;
  this.blacklist.clear();
  positions.forEach((position) => {
    promPositions.push(new Promise(async (resolve, reject) => {
      if(this.long.indexOf(position.symbol) < 0){
        // Position is not in long list.
        if(this.short.indexOf(position.symbol) < 0){
          // Position not in short list either.  Clear position.
          if(position.side == "long") side = "sell";
          else side = "buy";
          var promCO = this.submitOrder(Math.abs(position.qty), position.symbol, side);
          await promCO.then(() => {
            resolve();
          });
        }
        else{
          // Position in short list.
          if(position.side == "long") {
            // Position changed from long to short.  Clear long position and short instead
            var promCS = this.submitOrder(position.qty, position.symbol, "sell");
            await promCS.then(() => {
              resolve();
            });
          }
          else {
            if(Math.abs(position.qty) == this.qShort){
              // Position is where we want it.  Pass for now.
            }
            else{
              // Need to adjust position amount
              var diff = Number(Math.abs(position.qty)) - Number(this.qShort);
              if(diff > 0){
                // Too many short positions.  Buy some back to rebalance.
                side = "buy";
              }
              else{
                // Too little short positions.  Sell some more.
                side = "sell";
              }
              var promRebalance = this.submitOrder(Math.abs(diff), position.symbol, side);
              await promRebalance;
            }
            executed.short.push(position.symbol);
            this.blacklist.add(position.symbol);
            resolve();
          }
        }
      }
      else{
        // Position in long list.
        if(position.side == "short"){
          // Position changed from short to long.  Clear short position and long instead.
          var promCS = this.submitOrder(Math.abs(position.qty), position.symbol, "buy");
          await promCS.then(() => {
            resolve();
          });
        }
        else{
          if(position.qty == this.qLong){
            // Position is where we want it.  Pass for now.
          }
          else{
            // Need to adjust position amount.
            var diff = Number(position.qty) - Number(this.qLong);
            if(diff > 0){
              // Too many long positions.  Sell some to rebalance.
              side = "sell";
            }
            else{
              // Too little long positions.  Buy some more.
              side = "buy";
            }
            var promRebalance = this.submitOrder(Math.abs(diff), position.symbol, side);
            await promRebalance;
          }
          executed.long.push(position.symbol);
          this.blacklist.add(position.symbol);
          resolve();
        }
      }
    }));
  });
  await Promise.all(promPositions);

  // Send orders to all remaining stocks in the long and short list.
  var promLong = this.sendBatchOrder(this.qLong, this.long, 'buy');
  var promShort = this.sendBatchOrder(this.qShort, this.short, 'sell');

  var promBatches = [];
  this.adjustedQLong = -1;
  this.adjustedQShort = -1;

  await Promise.all([promLong, promShort]).then(async (resp) => {
    // Handle rejected/incomplete orders.
    resp.forEach(async (arrays, i) => {
      promBatches.push(new Promise(async (resolve, reject) => {
        if(i == 0) {
          arrays[1] = arrays[1].concat(executed.long);
          executed.long = arrays[1].slice();
        }
        else {
          arrays[1] = arrays[1].concat(executed.short);
          executed.short = arrays[1].slice();
        }
        // Return orders that didn't complete, and determine new quantities to purchase.
        if(arrays[0].length > 0 && arrays[1].length > 0){
          var promPrices = this.getTotalPrice(arrays[1]);

          await Promise.all(promPrices).then((resp) => {
            var completeTotal = resp.reduce((a, b) => a + b, 0);
            if(completeTotal != 0){
              if(i == 0){
                this.adjustedQLong = Math.floor(this.longAmount / completeTotal);
              }
              else{
                this.adjustedQShort = Math.floor(this.shortAmount / completeTotal);
              }
            }
          });
        }
        resolve();
      }));
    });
    await Promise.all(promBatches);
  }).then(async () => {
    // Reorder stocks that didn't throw an error so that the equity quota is reached.
    var promReorder = new Promise(async (resolve, reject) => {
      var promLong = [];
      if(this.adjustedQLong >= 0){
        this.qLong = this.adjustedQLong - this.qLong;
        executed.long.forEach(async (stock) => {
          promLong.push(new Promise(async (resolve, reject) => {
            var promLong = this.submitOrder(this.qLong, stock, 'buy');
            await promLong;
            resolve();
          })); 
        });
      }

      var promShort = [];
      if(this.adjustedQShort >= 0){
        this.qShort = this.adjustedQShort - this.qShort;
        executed.short.forEach(async(stock) => {
          promShort.push(new Promise(async (resolve, reject) => {
            var promShort = this.submitOrder(this.qShort, stock, 'sell');
            await promShort;
            resolve();
          }));
        });
      }
      var allProms = promLong.concat(promShort);
      if(allProms.length > 0){
        await Promise.all(allProms);
      }
      resolve();
    });
    await promReorder;
  });
}

// Re-rank all stocks to adjust longs and shorts.
async rerank(){
  await this.rank();

  // Grabs the top and bottom quarter of the sorted stock list to get the long and short lists.
  var longShortAmount = Math.floor(this.allStocks.length / 4);
  this.long = [];
  this.short = [];
  for(var i = 0; i < this.allStocks.length; i++){
    if(i < longShortAmount) this.short.push(this.allStocks[i].name);
    else if(i > (this.allStocks.length - 1 - longShortAmount)) this.long.push(this.allStocks[i].name);
    else continue;
  }
  // Determine amount to long/short based on total stock price of each bucket.
  var equity;
  await this.alpaca.getAccount().then((resp) => {
    equity = resp.equity;
  }).catch((err) => {console.log(err.error);});
  this.shortAmount = 0.30 * equity;
  this.longAmount = Number(this.shortAmount) + Number(equity);

  var promLong = await this.getTotalPrice(this.long);
  var promShort = await this.getTotalPrice(this.short);
  var longTotal;
  var shortTotal;
  await Promise.all(promLong).then((resp) => {
    longTotal = resp.reduce((a, b) => a + b, 0);
  });
  await Promise.all(promShort).then((resp) => {
    shortTotal = resp.reduce((a, b) => a + b, 0);
  });

  this.qLong = Math.floor(this.longAmount / longTotal);
  this.qShort = Math.floor(this.shortAmount / shortTotal);
}

// Mechanism used to rank the stocks, the basis of the Long-Short Equity Strategy.
async rank(){
  // Ranks all stocks by percent change over the past 10 minutes (higher is better).
  var promStocks = this.getPercentChanges(this.allStocks);
  await Promise.all(promStocks);

  // Sort the stocks in place by the percent change field (marked by pc).
  this.allStocks.sort((a, b) => {return a.pc - b.pc;});
}

// Get the total price of the array of input stocks.
getTotalPrice(stocks){
  var proms = [];
  stocks.forEach(async (stock) => {
    proms.push(new Promise(async (resolve, reject) => {
      await this.alpaca.getBars('minute', stock, {limit: 1}).then((resp) => {
        resolve(resp[stock][0].c);
      }).catch((err) => {console.log(err.error);});
    }));
  });
  return proms;
}

// Submit a batch order that returns completed and uncompleted orders.
async sendBatchOrder(quantity, stocks, side){
  var prom = new Promise(async (resolve, reject) => {
    var incomplete = [];
    var executed = [];
    var promOrders = [];
    stocks.forEach(async (stock) => {
      promOrders.push(new Promise(async (resolve, reject) => {
        if(!this.blacklist.has(stock)) {
          var promSO = this.submitOrder(quantity, stock, side);
          await promSO.then((resp) => {
            if(resp) executed.push(stock);
            else incomplete.push(stock);
            resolve();
          });
        }
        else resolve();
      }));
    });
    await Promise.all(promOrders).then(() => {
      resolve([incomplete, executed]);
    });
  });
  return prom;
}

Here’s a link to the entire script on the GitHub.

alpacahq/alpaca-trade-api-js
Contribute to alpacahq/alpaca-trade-api-js development by creating an account on GitHub.

What You Can Do

Within the classification of a Long-Short equity strategy, there are many variables that you can control to fine-tune your ranking system. I mentioned earlier that you can change the universe of stocks by altering the this.allStocks array at the top of the script. The amount of stocks you will long and short is another customization you can make. The script takes the top and bottom 25% to long and short, but you can change this to whatever you prefer. Just edit the “4” in the snippet below (4 representing ¼) and you can change the script to select a larger or smaller amount of stocks for each bucket.

var longShortAmount = Math.floor(this.allStocks.length / 4);

Another variable you can control is the percentage of equity to use for longing and shorting. This algorithm uses a 130/30 split which is popular amongst hedge funds. What this means is 130% of equity is used for taking long positions, and 30% of equity is used for short positions. You can edit that in the snippet below, choosing either percentage of equity or hard-coding amounts for your strategy.

// Determine amount to long/short based on total stock price of each bucket.
var equity;
await this.alpaca.getAccount().then((resp) => {
  equity = resp.equity;
}).catch((err) => {console.log(err.error);});
this.shortAmount = 0.30 * equity;
this.longAmount = Number(this.shortAmount) + Number(equity);

You can also change the frequency of portfolio rebalancing. At the moment, the script rebalances after every 1 minute. This is represented by the “60000” in the code below, representing 60000 milliseconds. You can change this to be more or less frequent (for example, if you only wanted rebalancing every 5 minutes, you would change 60000 to 5 * 60000 = 300000). However, be sure that you are not making your frequency too high or low. If you set it to be too frequent, you might reach the 200 requests per minute quota and the script would start throwing errors. If you set it to be too infrequent, the script may not be able to clear all positions in time for market close (you can adjust for this by increasing the 15 minute tolerance to market close, located in the run() function).

async run(){
  ...
    else {
      // Rebalance the portfolio.
      await this.rebalance();
    }
  }, 60000);
}

The final variable that you can easily manipulate is the ranking system. In this script, the stocks are ranked in terms of percent change in stock price over the past 10 minutes. This means that the algorithm is betting stocks that are doing well will continue to do well, and vice versa. You can change the ranking system by changing the function rank(). In this function, you can rank the stocks in whatever manner you please, just make sure you input the rank in the field “pc” for each stock in the allStocks array, where higher numbers is better (0 is the worst stock, 5 is a better stock). This way, the function rerank() will order the allStocks array least to greatest by the “pc” field, which then allows the script to split up the stocks into buckets.

// Get percent changes of the stock prices over the past 10 minutes.
getPercentChanges(allStocks){
  var length = 10;
  var promStocks = [];
  allStocks.forEach((stock) => {
    promStocks.push(new Promise(async (resolve, reject) => {
      await this.alpaca.getBars('minute', stock.name, {limit: length}).then((resp) => {
        stock.pc  = (resp[stock.name][length - 1].c - resp[stock.name][0].o) / resp[stock.name][0].o;
      }).catch((err) => {console.log(err.error);});
      resolve();
    }));
  });
  return promStocks;
}

// Mechanism used to rank the stocks, the basis of the Long-Short Equity Strategy.
async rank(){
  // Ranks all stocks by percent change over the past 10 minutes (higher is better).
  var promStocks = this.getPercentChanges(this.allStocks);
  await Promise.all(promStocks);

  // Sort the stocks in place by the percent change field (marked by pc).
  this.allStocks.sort((a, b) => {return a.pc - b.pc;});
}

There are other customizations you can make to this script (for example, buying more shares of the highest ranked stock in the long bucket and buying less shares of the lowest ranked stock in the long bucket, and then doing the same for the short bucket), but those changes require more intricate code changes than simply changing one number/area of code.


Technology and services are offered by AlpacaDB, Inc. Brokerage services are provided by Alpaca Securities LLC, member FINRA/SIPC. Alpaca Securities LLC is a wholly-owned subsidiary of AlpacaDB, Inc.

Algorithmic Trading Basics

Alpaca Team

API-first stock brokerage. *Securities are offered through Alpaca Securities LLC* http://alpaca.markets/#disclosures