Tradier Client

Node.js Tradier Brokerage API written in typescript.

Current Functionality

• Market Data
• Fundamentals (Beta use at own risk)

Future Planned Functionality

• Stream Endpoint
• OAuth Authentication
• Account
• Trading
• Watchlist

Tradier

Brokerage Reinvented.

Tradier is a REST-based, open, and secure API for investors, advisors, and traders.

Tradier Documentation

Access Token

You will receive your Tradier API Access Token after you create an account.

Depending on what type of account you create will determine the type of access token you will receive.

• Sandbox
• Brokerage

Note: Sandbox does not work with every endpoint and may contain delayed information.

Installation

npm i --save @reycodev/tradier-client

Usage

Initialize the client.

import { TradierAccountType, TradierClient, TradierClientOptions } from '@reycodev/tradier-client';

const options: TradierClientOptions = {
  accessToken: '##########' // Token receieved after creating tradier account
  accountType: TradierAccountType.SANDBOX // Depends on type of account created.
}

const tradier: TradierClient = new TradierClient(options);

Market

Implemented Endpoints:

• Get Quotes
• Get Option Chains
• Get Option Strikes
• Get Option Expirations
• Get Historical Quotes
• Get Time and Sales
• Get ETB Securities
• Get Clock
• Get Calendar
• Get Companies
• Get Lookup Symbol

Examples:

// Get Quotes
tradier.market.getQuotes(['spy', 'amd'])
  .then((response) => console.log('response', response))
  .catch((error) => console.error(error));
// Get Option Questions
tradier.market.getOptionChains('spy', '2019-05-17')
  .then((response) => console.log('response', response))
  .catch((error) => console.error(error));

Fundamentals

Implemented Endpoints:

• Get Company
• Get Corporate Calendars
• Get Dividends
• Get Corporate Actions
• Get Rations
• Get Financial Reports
• Get Price Statistics

Examples:

// Get Company Information
tradier.fundamentals.getCompany(['spy', 'amd'])
  .then((response) => console.log('response', response))
  .catch((error) => console.error(error));
  // Get Corporate Calendars
tradier.fundamentals.getCorporateCalendars(['spy', 'amd'])
  .then((response) => console.log('response', response))
  .catch((error) => console.error(error));

Development

Decisions:

• Trying to follow Inversion of Control with Dependency Injection (Needs some more refactoring)
• Went with promises but thought about observables (rxjs) but didn't want to have that dependency.
  • Observables seem like a viable option because it could help with real time updates.

Improvements:

• Add Linting
• Add Unit Tests
• Add Typings for responses
• Add more endpoints for tradier
• Add bundling process to allow for use on different environments such as browser.

Miscellaneous

NestJs

Planned on creating a Nestjs library using this package. In the mean time, you can follow this to create your own.

tradier.service.ts

import { Injectable } from '@nestjs/common';
import { TradierClient } from '@reycodev/tradier-client';

@Injectable()
export class TradierService extends TradierClient {}

tradier.module.ts

import { Module, Provider } from '@nestjs/common';
import { TradierClient, TradierAccountType, TradierClientOptions } from '@reycodev/tradier-client';

import { TradierService } from './services';

// Recomend not commiting access token
const tradierToken: string = '######' 

// Probably should be its own file.
const tradierServiceFactory: Provider = {
  provide: TradierService,
  useFactory: () => {
    return new TradierClient({
      accessToken: tradierToken,
      accountType: TradierAccountType.SANDBOX,
    });
  }
}

@Module({
  imports: [],
  providers: [
    tradierServiceFactory,
  ],
  exports: [
    TradierService,
  ],
})
export class TradierModule {}