Alpaca Stock Trading Serverless App

⚠️ WARNING
Run at your own risk! This project uses basic moving averages, it is highly recommended to write your own algorithms and test heavily before ever using real assets.

Prerequisites

• Terraform installed
• Serverless Framework installed
• Personal AWS account created

Setup

1. Create an AWS credentials profile with programmatic access named "alpaca"

   $ aws configure --profile alpaca
   

2. Create an S3 bucket in the us-east-1 region for your terraform state. Once done, update the configuration:

    ./terraform/env/dev/main.tf
   
    bucket  = "alpaca-terraform" (change to your bucket name)
   

3. Create an Alpaca Market account (https://alpaca.markets/). You do not need to add money to your live account to test out this API. Make sure you are using API keys under the "Paper" account for testing. "Paper" is the name of the Alpaca testing environment that allows for you to use fake money against the live market for simulation. (Just don't put money in the live one until you're ready and there's nothing to worry about)

4. Create a new AWS Secrets Manager record with the following name and value. The beginning "dev" is important for the specific serverless stage that you ar deploying. If you create a "prod" stage later then you'd create another record with name "prod/alpaca".

    name: dev/alpaca
   
    {
        "keyId": "YOUR_PAPER_API_KY",
        "secretKey": "YOUR_PAPER_SECRET_KEY",
        "paper": "true",
        "usePolygon": "false"
    }
   

Deploy

Run the following command inside the project directory:

    $ cd serverless && npm run deploy

This will deploy using the ./scripts/deploy.sh

• Will want to pass in the environment/stage as a param for the script at some point

Destroy

Run the following command to teardown everything, you should do this when not developing to reduce costs of the NAT gateway ($0.04 / hour = $35 / month if you leave it up).

    $ cd serverless && npm run destroy

This will destroy using the ./scripts/destroy.sh

• Will want to pass in the environment/stage as a param for the script at some point