Giter VIP home page Giter VIP logo

tradier-client's Introduction

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.

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

tradier-client's People

Contributors

pscanlon1 avatar codebycorey avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.