#trading #stock #async #tdameritrade

tdameritrade_rust

An unofficial rust library for TD Ameritrade's API

6 releases

0.1.6 Jun 3, 2023
0.1.5 Jun 2, 2023
0.1.4 Nov 5, 2022
0.1.3 Oct 27, 2022
0.1.2 Sep 29, 2022

#93 in Finance

50 downloads per month

MIT license

190KB
3K SLoC

tdameritrade_rust

An unofficial rust library for TD Ameritrade's API

New in version 0.1.6

  • Implemented cloning for SyncTDAClient and AsyncTDAClient

New in version 0.1.5

  • Added interior mutability

New in version 0.1.4

  • Created OrderBuilder to construct orders for TD Ameritrade easier.
  • Created equity order templates with OrderBuilder
  • Updated trading_async.rs and trading_sync.rs under examples to showcase OrderBuilder
  • Integrated creating new client with TDAClient Error
  • Updated account output struct

tdameritrade_rust's OrderBuilder was heavily inspired by Alex Golec's OrderBuilder from tda api. His documentation of OrderBuilder is an amazing resource, and should work with the OrderBuilder from this library.

Features

  • tdameritrade_rust supports both sync/async
  • tdameritrade_rust automatically handles authentification
  • tdameritrade_rust eases creating token file from TD Ameritrade

Installation

Add this to your Cargo.toml

[dependencies]
tdameritrade_rust = "0.1.6"

Getting Started

  • Register at the TD Ameritrade API Website
  • Go to the My Apps section and add a new app
  • Click on your app and copy the consumer key
  • Click on the details section of your app and copy the callback url
  • Download chromedriver
  • Copy code below, replace fields, run code, and login when prompted to receive a token file from TD Ameritrade
use tdameritrade_rust::init;

fn main() {
    // Create Token File
    init::create_token_file(
        "chrome_driver_path".into(), // Path To Chromedriver
        "client_id@AMER.OAUTHAP".into(), // Client Id (Consumer Key)
        "redirect_uri".into(), // Redirect URI (Callback URL)
        "token_file_path".into(), // Where To Put Token File After Completion 
    )
}

Synchronous

  • After creating the token file, create a TD Ameritrade Client to access the API endpoints. Here's an example with the synchronous client
use tdameritrade_rust::{
    output::quotes::{QuoteType, Quotes},
    SyncTDAClient, TDAClientError,
};
mod config;

fn main() -> Result<(), TDAClientError> {
    // Create Synchronous TDAClient
    let client = SyncTDAClient::new(
        config::client_id(),
        config::redirect_uri(),
        config::token_path(),
    )?;

    // Get Quote
    let symbol = "AAPL";
    let res = client.get_quote(symbol)?;
    let res_json = serde_json::from_str::<Quotes>(&res)?;

    if let QuoteType::Equity(equity) = &res_json.symbol[symbol] {
        println!("{}", equity.close_price);
    }

    // Get Quotes
    let symbols = vec!["AAPL", "AMZN", "AMD", "NVDA"];
    let res = client.get_quotes(&symbols)?;
    let res_json = serde_json::from_str::<Quotes>(&res)?;

    for symbol in symbols.into_iter() {
        if let QuoteType::Equity(equity) = &res_json.symbol[symbol] {
            println!("{}", equity.close_price)
        }
    }

    Ok(())
}

Asynchronous

  • After creating the token file, create a TD Ameritrade Client to access the API endpoints. Here's an example with the asynchronous client
use tdameritrade_rust::{
    output::quotes::{QuoteType, Quotes},
    AsyncTDAClient, TDAClientError,
};
mod config;

#[tokio::main]
async fn main() -> Result<(), TDAClientError> {
    // Create Asynchronous TDAClient
    let client = AsyncTDAClient::new(
        config::client_id(),
        config::redirect_uri(),
        config::token_path(),
    )?;

    // Get Quote
    let symbol = "AAPL";
    let res = client.get_quote(symbol).await?;
    let res_json = serde_json::from_str::<Quotes>(&res)?;

    if let QuoteType::Equity(equity) = &res_json.symbol[symbol] {
        println!("{}", equity.close_price);
    }

    // Get Quotes
    let symbols = vec!["AAPL", "AMZN", "AMD", "NVDA"];
    let res = client.get_quotes(&symbols).await?;
    let res_json = serde_json::from_str::<Quotes>(&res)?;

    for symbol in symbols.into_iter() {
        if let QuoteType::Equity(equity) = &res_json.symbol[symbol] {
            println!("{}", equity.close_price)
        }
    }

    Ok(())
}

Future Plans

  • I plan to make the watchlist endpoint easier to use
  • I plan to support streaming

Disclaimer

tdameritrade_rust is released under the MIT license

tdameritrade_rust is an unofficial API wrapper. It is in no way endorsed by or affiliated with TD Ameritrade or any associated organization. The authors will accept no responsibility for any damage that might stem from use of this package. See the LICENSE file for more details.

Dependencies

~13–26MB
~390K SLoC