Struct Client 

pub struct Client { /* private fields */ }

TradeStation API client with automatic token management.

Example

use tradestation_api::{Client, Credentials};

let creds = Credentials::new("id", "secret");
let mut client = Client::new(creds);
client.authenticate("auth_code").await?;

let accounts = client.get_accounts().await?;

Implementations

impl Client

pub async fn get_accounts(&mut self) -> Result<Vec<Account>, Error>

Get all trading accounts associated with the authenticated user.

pub async fn get_balances( &mut self, account_ids: &[&str], ) -> Result<Vec<Balance>, Error>

Get real-time balances for the specified accounts.

pub async fn get_positions( &mut self, account_ids: &[&str], ) -> Result<Vec<Position>, Error>

Get open positions for the specified accounts.

pub async fn get_orders( &mut self, account_ids: &[&str], ) -> Result<Vec<Order>, Error>

Get active orders for the specified accounts.

pub async fn get_bod_balances( &mut self, account_ids: &[&str], ) -> Result<Vec<BodBalance>, Error>

Get beginning-of-day balance snapshots for the specified accounts.

pub async fn get_orders_by_id( &mut self, account_ids: &[&str], order_ids: &[&str], ) -> Result<Vec<Order>, Error>

Get specific orders by order ID.

pub async fn get_historical_orders( &mut self, account_ids: &[&str], since: &str, ) -> Result<Vec<Order>, Error>

Get historical (filled/cancelled) orders for the specified accounts.

since is a date string in YYYY-MM-DD format specifying how far back to look. TradeStation limits historical orders to ~90 days.

pub async fn get_historical_orders_by_id( &mut self, account_ids: &[&str], order_ids: &[&str], ) -> Result<Vec<Order>, Error>

Get specific historical orders by order ID.

pub async fn get_wallets( &mut self, account_ids: &[&str], ) -> Result<Vec<Wallet>, Error>

Get cryptocurrency wallet balances for the specified accounts.

impl Client

pub fn new(credentials: Credentials) -> Self

Create a new client targeting the production API.

pub fn with_sim(self) -> Self

Use the simulation API instead of production.

pub fn with_base_url(self, url: impl Into<String>) -> Self

Override the base URL (useful for testing with mock servers).

pub fn with_token(self, token: Token) -> Self

Set a pre-existing token (e.g., loaded from persistent storage).

pub async fn authenticate(&mut self, code: &str) -> Result<&Token, Error>

Exchange an authorization code for tokens, completing the OAuth2 flow.

pub async fn access_token(&mut self) -> Result<String, Error>

Get a valid access token, automatically refreshing if expired.

pub async fn get(&mut self, path: &str) -> Result<Response, Error>

Make an authenticated GET request to the given path.

pub async fn post<T: Serialize>( &mut self, path: &str, body: &T, ) -> Result<Response, Error>

Make an authenticated POST request with a JSON body.

pub async fn delete(&mut self, path: &str) -> Result<Response, Error>

Make an authenticated DELETE request.

pub async fn put<T: Serialize>( &mut self, path: &str, body: &T, ) -> Result<Response, Error>

Make an authenticated PUT request with a JSON body.

pub fn token_info(&self) -> Option<&Token>

Get the current token (for status display or persistence).

pub fn base_url(&self) -> &str

Get the current base URL.

impl Client

pub async fn place_order( &mut self, order: &OrderRequest, ) -> Result<OrderResponse, Error>

Place a new order.

Errors

Returns Error::Api if the order is rejected by TradeStation.

pub async fn confirm_order( &mut self, order: &OrderRequest, ) -> Result<OrderResponse, Error>

Preview an order without executing it.

Returns estimated fill details and any validation errors.

pub async fn cancel_order( &mut self, order_id: &str, ) -> Result<OrderResponse, Error>

Cancel an existing order by its order ID.

pub async fn replace_order( &mut self, order_id: &str, order: &OrderRequest, ) -> Result<OrderResponse, Error>

Replace (modify) an existing order with new parameters.

pub async fn place_order_group( &mut self, group: &OrderGroupRequest, ) -> Result<OrderResponse, Error>

Place an OCO or bracket order group.

pub async fn confirm_order_group( &mut self, group: &OrderGroupRequest, ) -> Result<OrderResponse, Error>

Preview an order group without executing.

pub async fn get_activation_triggers( &mut self, ) -> Result<Vec<ActivationTrigger>, Error>

Get available activation triggers for conditional orders.

pub async fn get_routes(&mut self) -> Result<Vec<Route>, Error>

Get available order routing destinations.

impl Client

pub async fn get_bars( &mut self, query: &BarChartQuery, ) -> Result<Vec<Bar>, Error>

Fetch historical bar chart data for a symbol.

Errors

Returns Error::Api if the API request fails.

pub async fn get_quotes( &mut self, symbols: &[&str], ) -> Result<Vec<Quote>, Error>

Fetch quote snapshots for one or more symbols.

Accepts a slice of ticker symbols (e.g., &["AAPL", "MSFT"]).

pub async fn get_symbol_info( &mut self, symbols: &[&str], ) -> Result<Vec<SymbolInfo>, Error>

Fetch symbol definition metadata.

pub async fn get_crypto_pairs(&mut self) -> Result<Vec<String>, Error>

Fetch available cryptocurrency trading pairs.

pub async fn get_option_expirations( &mut self, underlying: &str, ) -> Result<Vec<OptionExpiration>, Error>

Fetch option expiration dates for an underlying symbol.

pub async fn get_option_strikes( &mut self, underlying: &str, ) -> Result<Vec<OptionStrike>, Error>

Fetch available strike prices for an underlying symbol.

pub async fn get_option_spread_types( &mut self, ) -> Result<Vec<SpreadType>, Error>

Fetch available option spread types (e.g., Vertical, Calendar).

pub async fn get_option_risk_reward( &mut self, request: &RiskRewardRequest, ) -> Result<RiskRewardResponse, Error>

Analyze option risk/reward for a given trade.

impl Client

pub async fn stream_quotes( &mut self, symbols: &[&str], ) -> Result<BoxStream<StreamQuote>, Error>

Stream live quote updates for one or more symbols.

Returns an async stream of StreamQuote values including StreamStatus messages (EndSnapshot, GoAway).

pub async fn stream_bars( &mut self, symbol: &str, interval: &str, unit: &str, ) -> Result<BoxStream<StreamBar>, Error>

Stream live bar updates for a symbol.

Parameters

• symbol: Ticker symbol (e.g., “AAPL”)
• interval: Bar interval (e.g., “1”, “5”)
• unit: Bar unit (e.g., “Minute”, “Daily”)

pub async fn stream_market_depth_quotes( &mut self, symbol: &str, ) -> Result<BoxStream<StreamMarketDepthQuote>, Error>

Stream Level 2 market depth quotes for a symbol.

pub async fn stream_market_depth_aggregates( &mut self, symbol: &str, ) -> Result<BoxStream<StreamMarketDepthAggregate>, Error>

Stream market depth aggregates for a symbol.

pub async fn stream_option_chains( &mut self, underlying: &str, ) -> Result<BoxStream<StreamOptionChain>, Error>

Stream option chain updates for an underlying symbol.

pub async fn stream_option_quotes( &mut self, legs: &[&str], ) -> Result<BoxStream<StreamOptionQuote>, Error>

Stream option quote updates for specific option legs.

pub async fn stream_orders( &mut self, account_ids: &[&str], ) -> Result<BoxStream<StreamOrder>, Error>

Stream order status updates for the specified accounts.

pub async fn stream_orders_by_id( &mut self, account_ids: &[&str], order_ids: &[&str], ) -> Result<BoxStream<StreamOrder>, Error>

Stream order updates for specific order IDs.

pub async fn stream_positions( &mut self, account_ids: &[&str], ) -> Result<BoxStream<StreamPosition>, Error>

Stream position updates for the specified accounts.