@huskly/schwab-client 0.1.0

package/README.md

@@ -0,0 +1,269 @@
+# @huskly/schwab-client
+
+A TypeScript client library for the Schwab Market Data and Trading API.
+
+## Installation
+
+```bash
+npm install @huskly/schwab-client
+```
+
+## Requirements
+
+- Node.js >= 20.0.0
+- A valid Schwab API access token
+
+## Usage
+
+```typescript
+import { SchwabClient } from '@huskly/schwab-client';
+
+const client = new SchwabClient('your-access-token');
+```
+
+### Market Data
+
+#### Get Quotes
+
+```typescript
+const quotes = await client.getQuotes(['AAPL', 'GOOGL', 'MSFT']);
+console.log(quotes['AAPL'].quote.lastPrice);
+```
+
+#### Get Price History
+
+```typescript
+// 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(),
+});
+```
+
+#### Get VIX Level
+
+```typescript
+const vix = await client.getVixLevel();
+console.log(`VIX: ${vix}`);
+```
+
+#### Search Instruments
+
+```typescript
+const results = await client.searchInstruments('AAPL', 'symbol-search');
+```
+
+#### Get Market Movers
+
+```typescript
+const movers = await client.getMovers('$SPX', 'PERCENT_CHANGE_UP');
+console.log(movers.screeners);
+```
+
+### Options
+
+#### Get Available Expiries
+
+```typescript
+const expiries = await client.getAvailableExpiries(
+  'SPY',
+  'CALL',
+  '2025-01-01',
+  '2025-06-30'
+);
+```
+
+#### Get Option Chain
+
+```typescript
+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
+
+```typescript
+const option = await client.getOptionQuote({
+  symbol: 'SPY',
+  expiry: new Date('2025-01-17'),
+  strike: 600,
+  type: 'call',
+});
+```
+
+### Account
+
+#### Get Account Balances
+
+```typescript
+const balances = await client.getAccountBalances();
+console.log(`Equity: $${balances.equity}`);
+console.log(`Buying Power: $${balances.buyingPower}`);
+console.log(`Cash: $${balances.cashBalance}`);
+```
+
+#### Get Positions
+
+```typescript
+// All positions
+const positions = await client.getPositions();
+
+// Filter by symbol
+const applePositions = await client.getPositions('AAPL');
+```
+
+#### Get Account Numbers
+
+```typescript
+const accounts = await client.fetchAccountNumbers();
+for (const account of accounts) {
+  console.log(`Account: ${account.accountNumber}, Hash: ${account.hashValue}`);
+}
+```
+
+#### Get Transaction History
+
+```typescript
+const history = await client.fetchTransactionHistory(
+  new Date('2024-01-01'),
+  new Date()
+);
+```
+
+#### Get User Preferences
+
+```typescript
+const prefs = await client.getUserPreference();
+console.log(prefs.streamerInfo.streamerSocketUrl);
+```
+
+### Orders
+
+#### Fetch Orders
+
+```typescript
+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
+
+```typescript
+import type { SchwabOrderRequest } from '@huskly/schwab-client';
+
+const order: SchwabOrderRequest = {
+  session: 'NORMAL',
+  duration: 'DAY',
+  orderType: 'LIMIT',
+  orderStrategyType: 'SINGLE',
+  price: 150.00,
+  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
+
+```typescript
+const rate = await client.getRiskFreeRate(new Date());
+// Returns 0.02 (2%)
+```
+
+#### Get Current Date
+
+```typescript
+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 |
+| `getVixLevel()` | Get current VIX index level |
+| `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 |
+| `getExistingSpreads(symbol)` | Get existing option 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:
+
+```typescript
+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:
+
+```typescript
+try {
+  const quotes = await client.getQuotes(['INVALID']);
+} catch (error) {
+  if (error.message.includes('Unauthorized')) {
+    // Token expired or invalid
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SchwabClient } from "./schwabClient.js";
+export type { SchwabQuoteAssetMainType, SchwabQuoteReference, SchwabQuoteData, SchwabQuoteRegular, SchwabQuoteFundamental, SchwabQuoteResponse, OptionQuote, ExistingSpread, ISODateTime, SchwabSession, SchwabDuration, SchwabOrderType, SchwabComplexOrderStrategyType, SchwabRequestedDestination, SchwabLinkBasis, SchwabLinkType, SchwabStopType, SchwabPriceLinkBasis, SchwabTaxLotMethod, SchwabOrderLegType, SchwabInstruction, SchwabPositionEffect, SchwabQuantityType, SchwabDivCapGains, SchwabSpecialInstruction, SchwabOrderStrategyType, SchwabOrderStatus, SchwabAssetType, SchwabAccountBaseInstrument, SchwabCashEquivalentType, SchwabAccountCashEquivalent, SchwabAccountEquity, SchwabAccountFixedIncome, SchwabAccountMutualFund, SchwabApiCurrencyType, SchwabDeliverableAssetType, SchwabPutCall, SchwabOptionType, SchwabAccountApiOptionDeliverable, SchwabAccountOption, SchwabAccountsInstrument, SchwabOrderLeg, SchwabOrderActivityType, SchwabExecutionType, SchwabExecutionLeg, SchwabOrderActivity, SchwabOrder, SchwabOrdersResponse, SchwabInstrumentSearchProjection, SchwabInstrumentAssetType, SchwabFundamentalInstrument, SchwabBasicInstrument, SchwabBondInstrument, SchwabInstrumentResponse, SchwabInstrumentSearchResponse, SchwabMoversIndexSymbol, SchwabMoversSort, SchwabMoversFrequency, SchwabMoversDirection, SchwabMover, SchwabMoversResponse, SchwabOrderRequestInstrument, SchwabOrderRequestLeg, SchwabOrderRequest, PriceHistoryCandle, PriceHistoryResponse, } from "./types.js";
+export type { SchwabAccountDetails, SchwabAccountPosition, SchwabAccount, SchwabPosition, SchwabInstrument, SchwabTransferItem, SchwabTransaction, SchwabAccountTransactionHistory, SchwabUserPreferenceAccount, SchwabStreamerInfo, SchwabOffer, SchwabUserPreference, } from "./schwabApiTypes.js";
+export { ALL_SCHWAB_ORDER_TYPES, ALL_SCHWAB_INSTRUCTIONS } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAEV,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,cAAc,EAEd,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC3B,wBAAwB,EACxB,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,iCAAiC,EACjC,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EAEpB,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,EAE9B,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EAEpB,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAElB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,+BAA+B,EAC/B,2BAA2B,EAC3B,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Main client
+export { SchwabClient } from "./schwabClient.js";
+// Constants
+export { ALL_SCHWAB_ORDER_TYPES, ALL_SCHWAB_INSTRUCTIONS } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA8FjD,YAAY;AACZ,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/schwabApiTypes.d.ts

@@ -0,0 +1,126 @@
+export interface SchwabAccountDetails {
+    accountNumber: string;
+    positions: SchwabAccountPosition[];
+    liquidationValue: number;
+    availableFunds: number;
+    buyingPower: number;
+    cashBalance: number;
+}
+export interface SchwabAccountPosition {
+    symbol: string;
+    name: string;
+    amount: number;
+    averageTradePriceUsd: string;
+    value: number;
+    mark: string;
+    changePercent24Hr: string;
+    id: string;
+    type: "stock" | "option";
+}
+export interface SchwabAccount {
+    hashValue?: string;
+    securitiesAccount: {
+        accountNumber: string;
+        hashValue?: string;
+        positions: SchwabPosition[];
+        currentBalances: {
+            equity: number;
+            availableFunds: number;
+            buyingPower: number;
+            cashBalance: number;
+            liquidationValue: number;
+        };
+    };
+}
+export interface SchwabPosition {
+    shortQuantity: number;
+    longQuantity: number;
+    averagePrice: number;
+    currentDayProfitLoss: number;
+    currentDayProfitLossPercentage: number;
+    settledLongQuantity: number;
+    settledShortQuantity: number;
+    agedQuantity: number;
+    maintenanceRequirement: number;
+    averageLongPrice: number;
+    averageShortPrice: number;
+    taxLotAverageLongPrice: number;
+    taxLotAverageShortPrice: number;
+    longOpenProfitLoss: number;
+    shortOpenProfitLoss: number;
+    previousSessionLongQuantity: number;
+    previousSessionShortQuantity: number;
+    currentDayCost: number;
+    instrument: {
+        assetType: string;
+        cusip: string;
+        symbol: string;
+        underlyingSymbol?: string;
+        description: string;
+        instrumentId: number;
+        netChange?: number;
+        type: string;
+    };
+    marketValue: number;
+}
+export interface SchwabInstrument {
+    symbol?: string;
+    description?: string;
+    assetType?: string;
+    type?: string;
+}
+export interface SchwabTransferItem {
+    instrument?: SchwabInstrument;
+    amount?: number;
+    cost?: number;
+    fee?: number;
+    price?: number;
+    quantity?: number;
+    transferItemType?: string;
+    positionEffect?: string;
+    transactionId?: number;
+}
+export interface SchwabTransaction {
+    activityId: number;
+    time: string;
+    accountNumber: string;
+    type: string;
+    status: string;
+    subAccount: string;
+    tradeDate: string;
+    positionId: number;
+    orderId: number;
+    netAmount: number;
+    description?: string;
+    transferItems?: SchwabTransferItem[];
+}
+export interface SchwabAccountTransactionHistory {
+    accountNumber: string;
+    transactions: SchwabTransaction[];
+}
+export interface SchwabUserPreferenceAccount {
+    accountNumber: string;
+    primaryAccount: boolean;
+    type: string;
+    nickName: string;
+    accountColor: string;
+    displayAcctId: string;
+    autoPositionEffect: boolean;
+}
+export interface SchwabStreamerInfo {
+    streamerSocketUrl: string;
+    schwabClientCustomerId: string;
+    schwabClientCorrelId: string;
+    schwabClientChannel: string;
+    schwabClientFunctionId: string;
+}
+export interface SchwabOffer {
+    level2Permissions: boolean;
+    mktDataPermission: string;
+}
+export interface SchwabUserPreference {
+    accounts: SchwabUserPreferenceAccount[];
+    streamerInfo: SchwabStreamerInfo;
+    offers: SchwabOffer[];
+}
+//# sourceMappingURL=schwabApiTypes.d.ts.map

package/dist/schwabApiTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schwabApiTypes.d.ts","sourceRoot":"","sources":["../src/schwabApiTypes.ts"],"names":[],"mappings":"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"}

package/dist/schwabApiTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schwabApiTypes.js.map

package/dist/schwabApiTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schwabApiTypes.js","sourceRoot":"","sources":["../src/schwabApiTypes.ts"],"names":[],"mappings":""}

package/dist/schwabClient.d.ts

@@ -0,0 +1,96 @@
+import type { ExistingSpread, OptionQuote, PriceHistoryResponse, SchwabOrder, SchwabOrderRequest, SchwabOrderStatus, SchwabQuoteResponse, SchwabInstrumentSearchProjection, SchwabInstrumentResponse, SchwabMoversIndexSymbol, SchwabMoversSort, SchwabMoversFrequency, SchwabMoversResponse } from "./types.js";
+import type { SchwabAccountTransactionHistory, SchwabPosition, SchwabTransaction, SchwabUserPreference } from "./schwabApiTypes.js";
+/**
+ * Schwab Market Data and Trading API client.
+ *
+ * @example
+ * ```typescript
+ * import { SchwabClient } from '@huskly/schwab-client';
+ *
+ * const client = new SchwabClient('your-access-token');
+ * const quotes = await client.getQuotes(['AAPL', 'GOOGL']);
+ * ```
+ */
+export declare class SchwabClient {
+    private readonly accessToken;
+    /**
+     * Creates a new SchwabClient instance.
+     * @param accessToken - A valid Schwab API access token
+     */
+    constructor(accessToken: string);
+    today(): Date;
+    getRiskFreeRate(_date: Date): Promise<number>;
+    getQuotes(symbols: string[]): Promise<Record<string, SchwabQuoteResponse>>;
+    getPriceHistory({ symbol, days, startDate, endDate, }: {
+        symbol: string;
+        days?: number;
+        startDate?: number;
+        endDate?: number;
+    }): Promise<PriceHistoryResponse["candles"]>;
+    getVixLevel(): Promise<number | undefined>;
+    getAvailableExpiries(symbol: string, contractType: "PUT" | "CALL", fromDate: string, toDate: string): Promise<Date[]>;
+    getOptionChain(symbol: string, expiry: Date): Promise<OptionQuote[]>;
+    getOptionQuote(args: {
+        symbol: string;
+        expiry: Date;
+        strike: number;
+        type: "call" | "put";
+    }): Promise<OptionQuote | null>;
+    getAccountEquity(): Promise<number>;
+    getAccountBalances(): Promise<{
+        liquidationValue: number;
+        cashBalance: number;
+        availableFunds: number;
+        buyingPower: number;
+        equity: number;
+    }>;
+    getPositions(symbol?: string): Promise<SchwabPosition[]>;
+    getExistingSpreads(symbol: string): Promise<ExistingSpread[]>;
+    fetchAccountNumbers(): Promise<{
+        accountNumber: string;
+        hashValue: string;
+    }[]>;
+    fetchTransactionHistory(startDate?: Date, endDate?: Date): Promise<SchwabAccountTransactionHistory[]>;
+    fetchAccountTransactionHistory(accountHash: string, startDate?: Date, endDate?: Date): Promise<SchwabTransaction[]>;
+    fetchOrders(options: {
+        fromEnteredTime: Date;
+        toEnteredTime: Date;
+        maxResults?: number;
+        status?: SchwabOrderStatus;
+    }): Promise<{
+        accountNumber: string;
+        orders: SchwabOrder[];
+    }[]>;
+    fetchAccountOrders(accountHash: string, options: {
+        fromEnteredTime: Date;
+        toEnteredTime: Date;
+        maxResults?: number;
+        status?: SchwabOrderStatus;
+    }): Promise<SchwabOrder[]>;
+    /**
+     * Place an order for a specific account.
+     * Returns the order ID from the Location header on success.
+     */
+    placeOrder(accountHash: string, order: SchwabOrderRequest): Promise<{
+        orderId: string;
+    }>;
+    getUserPreference(): Promise<SchwabUserPreference>;
+    /**
+     * Search for instruments by symbol or description.
+     * @param symbol - The search term (symbol or description fragment)
+     * @param projection - The type of search to perform
+     * @returns Array of matching instruments
+     */
+    searchInstruments(symbol: string, projection: SchwabInstrumentSearchProjection): Promise<SchwabInstrumentResponse[]>;
+    /**
+     * Get top 10 movers for a specific index.
+     * @param symbolId - Index symbol ($DJI, $COMPX, $SPX, NYSE, NASDAQ, etc.)
+     * @param sort - Sort by VOLUME, TRADES, PERCENT_CHANGE_UP, or PERCENT_CHANGE_DOWN
+     * @param frequency - Frequency in minutes (0, 1, 5, 10, 30, 60). Default is 0.
+     * @returns List of top movers
+     */
+    getMovers(symbolId: SchwabMoversIndexSymbol, sort?: SchwabMoversSort, frequency?: SchwabMoversFrequency): Promise<SchwabMoversResponse>;
+    private headersToRecord;
+    private makeApiRequest;
+}
+//# sourceMappingURL=schwabClient.d.ts.map

package/dist/schwabClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schwabClient.d.ts","sourceRoot":"","sources":["../src/schwabClient.ts"],"names":[],"mappings":"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"}