@adaptic/utils 0.0.383 → 0.0.901

package/dist/types/alpaca/market-data/trades.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Trades Module
+ * Real-time and historical trade data using Alpaca SDK
+ */
+import { AlpacaClient } from "../client";
+import { AlpacaTrade, LatestTradesResponse, DataFeed } from "../../types/alpaca-types";
+/**
+ * Error thrown when trade operations fail
+ */
+export declare class TradeError extends Error {
+    code: string;
+    symbol?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, symbol?: string | undefined, details?: unknown | undefined);
+}
+/**
+ * Parameters for fetching historical trades
+ */
+export interface GetHistoricalTradesParams {
+    /** Stock symbol */
+    symbol: string;
+    /** Start date/time for the data range */
+    start: Date;
+    /** End date/time for the data range (defaults to now) */
+    end?: Date;
+    /** Maximum number of trades to return */
+    limit?: number;
+    /** Data feed (sip for premium, iex for free tier) */
+    feed?: DataFeed;
+}
+/**
+ * Get latest trade for a single symbol
+ * @param client - AlpacaClient instance
+ * @param symbol - Stock symbol to get trade for
+ * @param feed - Optional data feed (sip, iex, delayed_sip)
+ * @returns Latest trade for the symbol
+ * @throws TradeError if the request fails
+ */
+export declare function getLatestTrade(client: AlpacaClient, symbol: string, feed?: DataFeed): Promise<AlpacaTrade>;
+/**
+ * Get latest trades for multiple symbols
+ * @param client - AlpacaClient instance
+ * @param symbols - Array of stock symbols
+ * @param feed - Optional data feed (sip, iex, delayed_sip)
+ * @returns Object containing trades for all requested symbols
+ * @throws TradeError if the request fails
+ */
+export declare function getLatestTrades(client: AlpacaClient, symbols: string[], feed?: DataFeed): Promise<LatestTradesResponse>;
+/**
+ * Get historical trades with automatic pagination
+ * @param client - AlpacaClient instance
+ * @param params - Parameters for fetching historical trades
+ * @returns Array of trades for the symbol
+ * @throws TradeError if the request fails
+ */
+export declare function getHistoricalTrades(client: AlpacaClient, params: GetHistoricalTradesParams): Promise<AlpacaTrade[]>;
+/**
+ * Get current price for a symbol
+ * Uses mid-point of latest quote if available, otherwise falls back to last trade price
+ * @param client - AlpacaClient instance
+ * @param symbol - Stock symbol
+ * @param feed - Optional data feed (sip, iex, delayed_sip)
+ * @returns Current price for the symbol
+ * @throws TradeError if unable to get price
+ */
+export declare function getCurrentPrice(client: AlpacaClient, symbol: string, feed?: DataFeed): Promise<number>;
+/**
+ * Get current prices for multiple symbols
+ * Uses mid-point of latest quote if available, otherwise falls back to last trade price
+ * @param client - AlpacaClient instance
+ * @param symbols - Array of stock symbols
+ * @param feed - Optional data feed (sip, iex, delayed_sip)
+ * @returns Map of symbol to current price
+ */
+export declare function getCurrentPrices(client: AlpacaClient, symbols: string[], feed?: DataFeed): Promise<Map<string, number>>;
+/**
+ * Get trade volume summary for a symbol over a time period
+ * @param client - AlpacaClient instance
+ * @param symbol - Stock symbol
+ * @param start - Start date/time
+ * @param end - End date/time (defaults to now)
+ * @returns Total volume and trade count for the period
+ */
+export declare function getTradeVolume(client: AlpacaClient, symbol: string, start: Date, end?: Date): Promise<{
+    totalVolume: number;
+    tradeCount: number;
+    avgTradeSize: number;
+}>;
+declare const _default: {
+    getLatestTrade: typeof getLatestTrade;
+    getLatestTrades: typeof getLatestTrades;
+    getHistoricalTrades: typeof getHistoricalTrades;
+    getCurrentPrice: typeof getCurrentPrice;
+    getCurrentPrices: typeof getCurrentPrices;
+    getTradeVolume: typeof getTradeVolume;
+};
+export default _default;
+//# sourceMappingURL=trades.d.ts.map

package/dist/types/alpaca/market-data/trades.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trades.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/market-data/trades.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,QAAQ,EAET,MAAM,0BAA0B,CAAC;AAQlC;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IAG1B,IAAI,EAAE,MAAM;IACZ,MAAM,CAAC,EAAE,MAAM;IACf,OAAO,CAAC,EAAE,OAAO;gBAHxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,IAAI,CAAC;IACZ,yDAAyD;IACzD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAYD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,QAAQ,GACd,OAAO,CAAC,WAAW,CAAC,CA4DtB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,CAAC,EAAE,QAAQ,GACd,OAAO,CAAC,oBAAoB,CAAC,CAiF/B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,WAAW,EAAE,CAAC,CA8ExB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,QAAQ,GACd,OAAO,CAAC,MAAM,CAAC,CAoEjB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,CAAC,EAAE,QAAQ,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwG9B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,IAAI,EACX,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B5E;;;;;;;;;AAED,wBAOE"}

package/dist/types/alpaca/options/contracts.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Options Contracts Module
+ * Query and analyze option contracts
+ */
+import { AlpacaClient } from "../client";
+import { OptionContract, OptionType, GetOptionContractsParams } from "../../types/alpaca-types";
+/**
+ * Parameters for getting option chain
+ */
+export interface GetOptionChainParams {
+    /** Filter by expiration date (YYYY-MM-DD format) */
+    expirationDate?: string;
+    /** Filter by strike price range */
+    strikePrice?: {
+        min?: number;
+        max?: number;
+    };
+    /** Filter by option type (call or put) */
+    type?: OptionType;
+}
+/**
+ * ATM options result containing both call and put
+ */
+export interface ATMOptionsResult {
+    /** ATM call option if found */
+    call: OptionContract | null;
+    /** ATM put option if found */
+    put: OptionContract | null;
+    /** The strike price used for ATM determination */
+    strikePrice: number;
+    /** Current underlying price used for determination */
+    underlyingPrice: number;
+}
+/**
+ * Options chain grouped by expiration and strike
+ */
+export interface GroupedOptionChain {
+    /** The underlying symbol */
+    underlying: string;
+    /** Chain grouped by expiration date */
+    byExpiration: {
+        [expirationDate: string]: {
+            /** Calls at each strike */
+            calls: {
+                [strike: string]: OptionContract;
+            };
+            /** Puts at each strike */
+            puts: {
+                [strike: string]: OptionContract;
+            };
+        };
+    };
+    /** All available expiration dates */
+    expirations: string[];
+    /** All available strike prices */
+    strikes: number[];
+}
+/**
+ * Get option contracts for an underlying symbol with filters
+ *
+ * @param client - The AlpacaClient instance
+ * @param params - Query parameters for filtering contracts
+ * @returns Array of option contracts matching the criteria
+ * @throws Error if API request fails
+ *
+ * @example
+ * // Get all AAPL option contracts
+ * const contracts = await getOptionContracts(client, {
+ *   underlying_symbols: ['AAPL'],
+ * });
+ *
+ * @example
+ * // Get AAPL calls expiring in the next 30 days
+ * const today = new Date();
+ * const thirtyDaysOut = new Date(today.getTime() + 30 * 24 * 60 * 60 * 1000);
+ * const contracts = await getOptionContracts(client, {
+ *   underlying_symbols: ['AAPL'],
+ *   type: 'call',
+ *   expiration_date_gte: today.toISOString().split('T')[0],
+ *   expiration_date_lte: thirtyDaysOut.toISOString().split('T')[0],
+ * });
+ */
+export declare function getOptionContracts(client: AlpacaClient, params: GetOptionContractsParams): Promise<OptionContract[]>;
+/**
+ * Get a specific option contract by symbol or ID
+ *
+ * @param client - The AlpacaClient instance
+ * @param symbolOrId - Option contract symbol (e.g., AAPL230120C00150000) or contract ID
+ * @returns The option contract details
+ * @throws Error if contract not found or API request fails
+ *
+ * @example
+ * // Get contract by OCC symbol
+ * const contract = await getOptionContract(client, 'AAPL230120C00150000');
+ *
+ * @example
+ * // Get contract by ID
+ * const contract = await getOptionContract(client, 'contract-uuid-here');
+ */
+export declare function getOptionContract(client: AlpacaClient, symbolOrId: string): Promise<OptionContract>;
+/**
+ * Get option chain for a symbol with optional filters
+ *
+ * @param client - The AlpacaClient instance
+ * @param underlying - The underlying symbol (e.g., 'AAPL')
+ * @param params - Optional filter parameters
+ * @returns Array of option contracts in the chain
+ *
+ * @example
+ * // Get full option chain for AAPL
+ * const chain = await getOptionChain(client, 'AAPL');
+ *
+ * @example
+ * // Get AAPL puts at specific strike range
+ * const chain = await getOptionChain(client, 'AAPL', {
+ *   type: 'put',
+ *   strikePrice: { min: 140, max: 160 },
+ * });
+ */
+export declare function getOptionChain(client: AlpacaClient, underlying: string, params?: GetOptionChainParams): Promise<OptionContract[]>;
+/**
+ * Get available expiration dates for an underlying symbol
+ *
+ * @param client - The AlpacaClient instance
+ * @param underlying - The underlying symbol (e.g., 'AAPL')
+ * @returns Sorted array of expiration dates (YYYY-MM-DD format)
+ *
+ * @example
+ * const expirations = await getExpirationDates(client, 'AAPL');
+ * console.log(`Next expiration: ${expirations[0]}`);
+ */
+export declare function getExpirationDates(client: AlpacaClient, underlying: string): Promise<string[]>;
+/**
+ * Get available strike prices for an underlying at a specific expiration
+ *
+ * @param client - The AlpacaClient instance
+ * @param underlying - The underlying symbol
+ * @param expirationDate - The expiration date (YYYY-MM-DD format)
+ * @returns Sorted array of available strike prices
+ *
+ * @example
+ * const strikes = await getStrikePrices(client, 'AAPL', '2024-01-19');
+ */
+export declare function getStrikePrices(client: AlpacaClient, underlying: string, expirationDate: string): Promise<number[]>;
+/**
+ * Find ATM (at-the-money) options for an underlying
+ * Returns both call and put options at the strike price closest to current price
+ *
+ * @param client - The AlpacaClient instance
+ * @param underlying - The underlying symbol
+ * @param expirationDate - The expiration date (YYYY-MM-DD format)
+ * @param currentPrice - Current price of the underlying (required to determine ATM)
+ * @param type - Optional filter to return only call or put
+ * @returns ATM options result with call and/or put contracts
+ *
+ * @example
+ * // Get both ATM call and put
+ * const atm = await findATMOptions(client, 'AAPL', '2024-01-19', 175.50);
+ * console.log(`ATM Call: ${atm.call?.symbol}`);
+ * console.log(`ATM Put: ${atm.put?.symbol}`);
+ *
+ * @example
+ * // Get only ATM call
+ * const atm = await findATMOptions(client, 'AAPL', '2024-01-19', 175.50, 'call');
+ */
+export declare function findATMOptions(client: AlpacaClient, underlying: string, expirationDate: string, currentPrice: number, type?: OptionType): Promise<ATMOptionsResult>;
+/**
+ * Get grouped option chain organized by expiration and strike
+ *
+ * @param client - The AlpacaClient instance
+ * @param underlying - The underlying symbol
+ * @param expirationDates - Optional array of expiration dates to include
+ * @returns Grouped option chain structure
+ *
+ * @example
+ * const chain = await getGroupedOptionChain(client, 'AAPL');
+ * // Access calls at specific expiration and strike
+ * const call = chain.byExpiration['2024-01-19'].calls['175'];
+ */
+export declare function getGroupedOptionChain(client: AlpacaClient, underlying: string, expirationDates?: string[]): Promise<GroupedOptionChain>;
+/**
+ * Find options contracts within a delta range (approximated by strike distance from current price)
+ *
+ * @param client - The AlpacaClient instance
+ * @param underlying - The underlying symbol
+ * @param expirationDate - The expiration date
+ * @param currentPrice - Current price of the underlying
+ * @param targetDeltaPercent - Target delta as percentage of current price (e.g., 5 for 5%)
+ * @param type - Option type (call or put)
+ * @returns Array of contracts within the delta range
+ *
+ * @example
+ * // Find calls approximately 5% OTM
+ * const otmCalls = await findOptionsByDelta(client, 'AAPL', '2024-01-19', 175, 5, 'call');
+ */
+export declare function findOptionsByDelta(client: AlpacaClient, underlying: string, expirationDate: string, currentPrice: number, targetDeltaPercent: number, type: OptionType): Promise<OptionContract[]>;
+/**
+ * Find the nearest expiration date to a target number of days out
+ *
+ * @param client - The AlpacaClient instance
+ * @param underlying - The underlying symbol
+ * @param targetDays - Target number of days to expiration
+ * @returns The nearest available expiration date
+ *
+ * @example
+ * // Find expiration closest to 30 days out
+ * const expiration = await findNearestExpiration(client, 'AAPL', 30);
+ */
+export declare function findNearestExpiration(client: AlpacaClient, underlying: string, targetDays: number): Promise<string>;
+/**
+ * Parse OCC option symbol to extract components
+ *
+ * @param occSymbol - OCC option symbol (e.g., AAPL230120C00150000)
+ * @returns Parsed symbol components
+ *
+ * @example
+ * const parsed = parseOCCSymbol('AAPL230120C00150000');
+ * // Returns: { underlying: 'AAPL', expiration: '2023-01-20', type: 'call', strike: 150 }
+ */
+export declare function parseOCCSymbol(occSymbol: string): {
+    underlying: string;
+    expiration: string;
+    type: OptionType;
+    strike: number;
+} | null;
+/**
+ * Build OCC option symbol from components
+ *
+ * @param underlying - The underlying symbol
+ * @param expiration - Expiration date (YYYY-MM-DD format)
+ * @param type - Option type (call or put)
+ * @param strike - Strike price
+ * @returns OCC-formatted option symbol
+ *
+ * @example
+ * const symbol = buildOCCSymbol('AAPL', '2023-01-20', 'call', 150);
+ * // Returns: 'AAPL230120C00150000'
+ */
+export declare function buildOCCSymbol(underlying: string, expiration: string, type: OptionType, strike: number): string;
+/**
+ * Check if an option contract is tradable
+ *
+ * @param contract - The option contract to check
+ * @returns True if the contract is active and tradable
+ */
+export declare function isContractTradable(contract: OptionContract): boolean;
+/**
+ * Calculate days to expiration for a contract
+ *
+ * @param contract - The option contract
+ * @returns Number of calendar days until expiration
+ */
+export declare function getDaysToExpiration(contract: OptionContract): number;
+/**
+ * Check if a contract is expiring within N days
+ *
+ * @param contract - The option contract
+ * @param days - Number of days threshold
+ * @returns True if contract expires within the specified days
+ */
+export declare function isExpiringWithin(contract: OptionContract, days: number): boolean;
+declare const _default: {
+    getOptionContracts: typeof getOptionContracts;
+    getOptionContract: typeof getOptionContract;
+    getOptionChain: typeof getOptionChain;
+    getExpirationDates: typeof getExpirationDates;
+    getStrikePrices: typeof getStrikePrices;
+    findATMOptions: typeof findATMOptions;
+    getGroupedOptionChain: typeof getGroupedOptionChain;
+    findOptionsByDelta: typeof findOptionsByDelta;
+    findNearestExpiration: typeof findNearestExpiration;
+    parseOCCSymbol: typeof parseOCCSymbol;
+    buildOCCSymbol: typeof buildOCCSymbol;
+    isContractTradable: typeof isContractTradable;
+    getDaysToExpiration: typeof getDaysToExpiration;
+    isExpiringWithin: typeof isExpiringWithin;
+};
+export default _default;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/types/alpaca/options/contracts.d.ts.map

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

package/dist/types/alpaca/options/data.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Options Market Data Module
+ * Quotes, bars, and analytics for options using Alpaca SDK
+ */
+import { AlpacaClient } from "../client";
+import { OptionQuote, OptionTrade, OptionBar, OptionSnapshot, OptionGreeks, OptionsChainParams, OptionsChainResponse, TimeFrame } from "../../types/alpaca-types";
+/**
+ * Error class for options data operations
+ */
+export declare class OptionsDataError extends Error {
+    code: string;
+    symbol?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, symbol?: string | undefined, details?: unknown | undefined);
+}
+/**
+ * Options data feed type
+ */
+export type OptionsFeed = "opra" | "indicative";
+/**
+ * Get options chain with snapshots for an underlying symbol
+ * Returns option contracts with their latest quotes, trades, and Greeks
+ */
+export declare function getOptionsChain(client: AlpacaClient, params: OptionsChainParams): Promise<OptionsChainResponse>;
+/**
+ * Get latest option quotes for multiple symbols
+ */
+export declare function getLatestOptionsQuotes(client: AlpacaClient, symbols: string[]): Promise<Map<string, OptionQuote>>;
+/**
+ * Get latest option trades for multiple symbols
+ */
+export declare function getLatestOptionsTrades(client: AlpacaClient, symbols: string[]): Promise<Map<string, OptionTrade>>;
+/**
+ * Get option snapshots with Greeks for multiple symbols
+ */
+export declare function getOptionsSnapshots(client: AlpacaClient, symbols: string[]): Promise<Map<string, OptionSnapshot>>;
+/**
+ * Parameters for historical options bars request
+ */
+export interface GetHistoricalOptionsBarsParams {
+    /** Option contract symbols */
+    symbols: string[];
+    /** Bar timeframe (e.g., '1Min', '1Hour', '1Day') */
+    timeframe: TimeFrame;
+    /** Start date/time */
+    start?: Date;
+    /** End date/time */
+    end?: Date;
+    /** Maximum number of bars to return */
+    limit?: number;
+}
+/**
+ * Get historical option bars (OHLCV data)
+ */
+export declare function getHistoricalOptionsBars(client: AlpacaClient, params: GetHistoricalOptionsBarsParams): Promise<Map<string, OptionBar[]>>;
+/**
+ * Calculate implied volatility from option price (simplified approximation)
+ * For production use, consider using a proper Black-Scholes solver
+ */
+export declare function approximateImpliedVolatility(optionPrice: number, underlyingPrice: number, strike: number, daysToExpiration: number, riskFreeRate?: number, isCall?: boolean): number;
+/**
+ * Calculate option moneyness
+ */
+export declare function calculateMoneyness(underlyingPrice: number, strike: number, isCall: boolean): "ITM" | "ATM" | "OTM";
+/**
+ * Find ATM (at-the-money) strikes from an options chain
+ */
+export declare function findATMStrikes(snapshots: Map<string, OptionSnapshot>, underlyingPrice: number): {
+    callSymbol: string | null;
+    putSymbol: string | null;
+    strike: number;
+};
+/**
+ * Calculate put/call ratio from options chain
+ */
+export declare function calculatePutCallRatio(snapshots: Map<string, OptionSnapshot>): {
+    volumeRatio: number;
+    openInterestRatio: number;
+};
+/**
+ * Get option Greeks from a snapshot
+ */
+export declare function extractGreeks(snapshot: OptionSnapshot): OptionGreeks | null;
+/**
+ * Filter options chain by expiration date range
+ */
+export declare function filterByExpiration(snapshots: Map<string, OptionSnapshot>, minDays: number, maxDays: number): Map<string, OptionSnapshot>;
+/**
+ * Filter options chain by strike price range
+ */
+export declare function filterByStrike(snapshots: Map<string, OptionSnapshot>, minStrike: number, maxStrike: number): Map<string, OptionSnapshot>;
+/**
+ * Filter options chain by option type
+ */
+export declare function filterByType(snapshots: Map<string, OptionSnapshot>, type: "call" | "put"): Map<string, OptionSnapshot>;
+/**
+ * Get the bid-ask spread for an option
+ */
+export declare function getOptionSpread(quote: OptionQuote): {
+    spread: number;
+    spreadPercent: number;
+    midPrice: number;
+};
+/**
+ * Check if an option has sufficient liquidity
+ */
+export declare function hasGoodLiquidity(snapshot: OptionSnapshot, maxSpreadPercent?: number, minOpenInterest?: number): boolean;
+declare const _default: {
+    getOptionsChain: typeof getOptionsChain;
+    getLatestOptionsQuotes: typeof getLatestOptionsQuotes;
+    getLatestOptionsTrades: typeof getLatestOptionsTrades;
+    getOptionsSnapshots: typeof getOptionsSnapshots;
+    getHistoricalOptionsBars: typeof getHistoricalOptionsBars;
+    approximateImpliedVolatility: typeof approximateImpliedVolatility;
+    calculateMoneyness: typeof calculateMoneyness;
+    findATMStrikes: typeof findATMStrikes;
+    calculatePutCallRatio: typeof calculatePutCallRatio;
+    extractGreeks: typeof extractGreeks;
+    filterByExpiration: typeof filterByExpiration;
+    filterByStrike: typeof filterByStrike;
+    filterByType: typeof filterByType;
+    getOptionSpread: typeof getOptionSpread;
+    hasGoodLiquidity: typeof hasGoodLiquidity;
+};
+export default _default;
+//# sourceMappingURL=data.d.ts.map

package/dist/types/alpaca/options/data.d.ts.map

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

package/dist/types/alpaca/options/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Options Trading Module
+ * Provides functionality for options contracts, orders, strategies, and market data
+ */
+export { getOptionContracts, getOptionContract, getOptionChain, getExpirationDates, getStrikePrices, findATMOptions, getGroupedOptionChain, findOptionsByDelta, findNearestExpiration, parseOCCSymbol, buildOCCSymbol, isContractTradable, getDaysToExpiration, isExpiringWithin, } from "./contracts";
+export type { GetOptionChainParams, ATMOptionsResult, GroupedOptionChain, } from "./contracts";
+export { default as contracts } from "./contracts";
+export { createOptionOrder, buyToOpen, sellToClose, sellToOpen, buyToClose, validateMultiLegOrder, createMultiLegOptionOrder, createVerticalSpread, createIronCondor, createStraddle, createStrangle, closeOptionPosition, closeAllOptionPositions, exerciseOption, isOptionOrderTerminal, isOptionOrderCancelable, } from "./orders";
+export type { SingleLegOptionOrderParams, CloseOptionPositionParams, CloseAllOptionsResult, ExerciseOptionParams, MultiLegValidationResult, } from "./orders";
+export { default as orders } from "./orders";
+export { buildOptionSymbol, createVerticalSpread as createVerticalSpreadAdvanced, createIronCondor as createIronCondorAdvanced, createStraddle as createStraddleAdvanced, createCoveredCall, rollOptionPosition, createStrangle as createStrangleAdvanced, createButterflySpread, OptionStrategyError, } from "./strategies";
+export type { VerticalSpreadParams, IronCondorParams, StraddleParams, CoveredCallParams, RollPositionParams, StrangleParams, ButterflySpreadParams, } from "./strategies";
+export { default as strategies } from "./strategies";
+export { getOptionsChain, getLatestOptionsQuotes, getLatestOptionsTrades, getOptionsSnapshots, getHistoricalOptionsBars, approximateImpliedVolatility, calculateMoneyness, findATMStrikes, calculatePutCallRatio, extractGreeks, filterByExpiration, filterByStrike, filterByType, getOptionSpread, hasGoodLiquidity, OptionsDataError, } from "./data";
+export type { OptionsFeed, GetHistoricalOptionsBarsParams } from "./data";
+export { default as data } from "./data";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/alpaca/options/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/alpaca/options/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EAGrB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAEL,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EAGV,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,cAAc,EAGd,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EAGd,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EACL,iBAAiB,EACjB,oBAAoB,IAAI,4BAA4B,EACpD,gBAAgB,IAAI,wBAAwB,EAC5C,cAAc,IAAI,sBAAsB,EACxC,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,IAAI,sBAAsB,EACxC,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAEhB,YAAY,EAAE,WAAW,EAAE,8BAA8B,EAAE,MAAM,QAAQ,CAAC;AAE1E,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC"}