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:

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:

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 {}