@huskly/schwab-client

A TypeScript client library for the Schwab Market Data and Trading API.

Installation

npm install @huskly/schwab-client

Requirements

• Node.js >= 20.0.0
• A valid Schwab API access token

Usage

import { SchwabClient } from "@huskly/schwab-client";

const client = new SchwabClient("your-access-token");

Market Data

Get Quotes

const quotes = await client.getQuotes(["AAPL", "GOOGL", "MSFT"]);
console.log(quotes["AAPL"].quote.lastPrice);

Get Price History

// Last 30 days
const history = await client.getPriceHistory({ symbol: "AAPL", days: 30 });

// Custom date range
const history = await client.getPriceHistory({
  symbol: "AAPL",
  startDate: Date.parse("2024-01-01"),
  endDate: Date.now(),
});

Search Instruments

const results = await client.searchInstruments("AAPL", "symbol-search");

Get Market Movers

const movers = await client.getMovers("$SPX", "PERCENT_CHANGE_UP");
console.log(movers.screeners);

Options

Get Available Expiries

const expiries = await client.getAvailableExpiries(
  "SPY",
  "CALL",
  "2025-01-01",
  "2025-06-30",
);

Get Option Chain

const chain = await client.getOptionChain("SPY", new Date("2025-01-17"));
for (const option of chain) {
  console.log(
    `${option.symbol}: ${option.strike} ${option.isCall ? "C" : "P"} @ ${
      option.mid
    }`,
  );
}

Get Single Option Quote

const option = await client.getOptionQuote({
  symbol: "SPY",
  expiry: new Date("2025-01-17"),
  strike: 600,
  type: "call",
});

Account

Get Account Balances

const balances = await client.getAccountBalances();
console.log(`Equity: $${balances.equity}`);
console.log(`Buying Power: $${balances.buyingPower}`);
console.log(`Cash: $${balances.cashBalance}`);

Get Positions

// All positions
const positions = await client.getPositions();

// Filter by symbol
const applePositions = await client.getPositions("AAPL");

Get Account Numbers

const accounts = await client.fetchAccountNumbers();
for (const account of accounts) {
  console.log(`Account: ${account.accountNumber}, Hash: ${account.hashValue}`);
}

Get Transaction History

const history = await client.fetchTransactionHistory(
  new Date("2024-01-01"),
  new Date(),
);

Get User Preferences

const prefs = await client.getUserPreference();
console.log(prefs.streamerInfo.streamerSocketUrl);

Orders

Fetch Orders

const orders = await client.fetchOrders({
  fromEnteredTime: new Date("2024-01-01"),
  toEnteredTime: new Date(),
  status: "FILLED", // Optional filter
  maxResults: 100, // Optional limit
});

Place an Order

import type { SchwabOrderRequest } from "@huskly/schwab-client";

const order: SchwabOrderRequest = {
  session: "NORMAL",
  duration: "DAY",
  orderType: "LIMIT",
  orderStrategyType: "SINGLE",
  price: 150.0,
  orderLegCollection: [
    {
      instruction: "BUY",
      quantity: 10,
      instrument: {
        assetType: "EQUITY",
        symbol: "AAPL",
      },
    },
  ],
};

const accounts = await client.fetchAccountNumbers();
const { orderId } = await client.placeOrder(accounts[0].hashValue, order);
console.log(`Order placed: ${orderId}`);

Utilities

Get "Risk-Free" Rate

const rate = await client.getRiskFreeRate(new Date());
// Returns latest 13-week T-bill yield as a decimal (e.g. 0.053 for 5.3%)

Get Current Date

const today = client.today();

API Reference

Market Data Methods

Method	Description
getQuotes(symbols)	Get real-time quotes for multiple symbols
getPriceHistory(args)	Get historical price data
getAvailableExpiries(symbol, contractType, fromDate, toDate)	Get available option expiration dates
getOptionChain(symbol, expiry)	Get full options chain for a symbol and expiry
getOptionQuote(args)	Get quote for a specific option contract
searchInstruments(symbol, projection)	Search for instruments
getMovers(symbolId, sort?, frequency?)	Get top market movers

Account Methods

Method	Description
getAccountEquity()	Get total account equity
getAccountBalances()	Get detailed account balances
getPositions(symbol?)	Get account positions
getPutCreditSpreads(symbol)	Get existing PUT option credit spreads
fetchAccountNumbers()	Get all linked account numbers
fetchTransactionHistory(startDate?, endDate?)	Get transaction history
getUserPreference()	Get user preferences and streaming info

Order Methods

Method	Description
fetchOrders(options)	Get orders across all accounts
fetchAccountOrders(accountHash, options)	Get orders for specific account
placeOrder(accountHash, order)	Place a new order

Types

All types are exported from the package:

import type {
  SchwabQuoteResponse,
  SchwabOrder,
  SchwabOrderRequest,
  SchwabPosition,
  OptionQuote,
  PriceHistoryCandle,
  // ... and many more
} from "@huskly/schwab-client";

Error Handling

The client throws errors for failed API requests:

try {
  const quotes = await client.getQuotes(["INVALID"]);
} catch (error) {
  if (error.message.includes("Unauthorized")) {
    // Token expired or invalid
  }
}

License

MIT