@adaptic/utils 0.0.383 → 0.1.1

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,EACV,WAAW,EACX,8BAA8B,GAC/B,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC"}

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

@@ -0,0 +1,366 @@
+/**
+ * Options Orders Module
+ * Create and manage option orders
+ */
+import { AlpacaClient } from '../client';
+import { AlpacaOrder, PositionIntent, TimeInForce, CreateMultiLegOrderParams, OrderStatus } from '../../types/alpaca-types';
+/**
+ * Parameters for creating a single-leg option order
+ */
+export interface SingleLegOptionOrderParams {
+    /** Option contract symbol (e.g., AAPL230120C00150000) */
+    symbol: string;
+    /** Number of contracts to trade */
+    qty: number;
+    /** Order side: buy or sell */
+    side: 'buy' | 'sell';
+    /** Order type: market or limit */
+    type: 'market' | 'limit';
+    /** Limit price for limit orders (price per share, not per contract) */
+    limitPrice?: number;
+    /** Position intent: indicates opening or closing a position */
+    positionIntent: PositionIntent;
+    /** Time in force: day, gtc, ioc, fok, opg, cls */
+    timeInForce?: TimeInForce;
+    /** Optional client order ID for tracking */
+    clientOrderId?: string;
+}
+/**
+ * Parameters for closing an option position
+ */
+export interface CloseOptionPositionParams {
+    /** Specific quantity to close (defaults to full position) */
+    qty?: number;
+    /** Limit price for limit order close */
+    limitPrice?: number;
+    /** Time in force for the close order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Result of closing all option positions
+ */
+export interface CloseAllOptionsResult {
+    /** Orders created for closing positions */
+    orders: AlpacaOrder[];
+    /** Positions that failed to close */
+    failed: {
+        symbol: string;
+        error: string;
+    }[];
+    /** Total number of positions processed */
+    totalProcessed: number;
+}
+/**
+ * Parameters for exercising an option
+ */
+export interface ExerciseOptionParams {
+    /** Option contract symbol */
+    symbol: string;
+    /** Number of contracts to exercise (defaults to full position) */
+    qty?: number;
+}
+/**
+ * Multi-leg order validation result
+ */
+export interface MultiLegValidationResult {
+    /** Whether the order is valid */
+    isValid: boolean;
+    /** Validation errors if any */
+    errors: string[];
+    /** Validation warnings if any */
+    warnings: string[];
+}
+/**
+ * Create a single-leg option order
+ *
+ * @param client - The AlpacaClient instance
+ * @param params - Order parameters
+ * @returns The created order
+ * @throws Error if order creation fails
+ *
+ * @example
+ * // Buy to open 5 call contracts
+ * const order = await createOptionOrder(client, {
+ *   symbol: 'AAPL230120C00150000',
+ *   qty: 5,
+ *   side: 'buy',
+ *   type: 'limit',
+ *   limitPrice: 2.50,
+ *   positionIntent: 'buy_to_open',
+ *   timeInForce: 'day',
+ * });
+ *
+ * @example
+ * // Sell to close with market order
+ * const order = await createOptionOrder(client, {
+ *   symbol: 'AAPL230120C00150000',
+ *   qty: 5,
+ *   side: 'sell',
+ *   type: 'market',
+ *   positionIntent: 'sell_to_close',
+ * });
+ */
+export declare function createOptionOrder(client: AlpacaClient, params: SingleLegOptionOrderParams): Promise<AlpacaOrder>;
+/**
+ * Buy to open option contracts
+ *
+ * @param client - The AlpacaClient instance
+ * @param symbol - Option contract symbol
+ * @param qty - Number of contracts
+ * @param limitPrice - Optional limit price (market order if not provided)
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ *
+ * @example
+ * const order = await buyToOpen(client, 'AAPL230120C00150000', 5, 2.50);
+ */
+export declare function buyToOpen(client: AlpacaClient, symbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Sell to close option contracts
+ *
+ * @param client - The AlpacaClient instance
+ * @param symbol - Option contract symbol
+ * @param qty - Number of contracts
+ * @param limitPrice - Optional limit price (market order if not provided)
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ *
+ * @example
+ * const order = await sellToClose(client, 'AAPL230120C00150000', 5, 3.00);
+ */
+export declare function sellToClose(client: AlpacaClient, symbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Sell to open option contracts (short selling options)
+ *
+ * @param client - The AlpacaClient instance
+ * @param symbol - Option contract symbol
+ * @param qty - Number of contracts
+ * @param limitPrice - Optional limit price (market order if not provided)
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ *
+ * @example
+ * const order = await sellToOpen(client, 'AAPL230120P00140000', 5, 1.50);
+ */
+export declare function sellToOpen(client: AlpacaClient, symbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Buy to close option contracts (closing short options)
+ *
+ * @param client - The AlpacaClient instance
+ * @param symbol - Option contract symbol
+ * @param qty - Number of contracts
+ * @param limitPrice - Optional limit price (market order if not provided)
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ *
+ * @example
+ * const order = await buyToClose(client, 'AAPL230120P00140000', 5, 0.50);
+ */
+export declare function buyToClose(client: AlpacaClient, symbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Validate multi-leg order parameters
+ *
+ * @param params - Multi-leg order parameters
+ * @returns Validation result with errors and warnings
+ */
+export declare function validateMultiLegOrder(params: CreateMultiLegOrderParams): MultiLegValidationResult;
+/**
+ * Create a multi-leg option order (spreads, straddles, etc.)
+ *
+ * @param client - The AlpacaClient instance
+ * @param params - Multi-leg order parameters
+ * @returns The created order
+ * @throws Error if validation fails or order creation fails
+ *
+ * @example
+ * // Create a vertical call spread
+ * const order = await createMultiLegOptionOrder(client, {
+ *   order_class: 'mleg',
+ *   qty: '1',
+ *   type: 'limit',
+ *   limit_price: '1.50',
+ *   time_in_force: 'day',
+ *   legs: [
+ *     {
+ *       symbol: 'AAPL230120C00150000',
+ *       ratio_qty: '1',
+ *       side: 'buy',
+ *       position_intent: 'buy_to_open',
+ *     },
+ *     {
+ *       symbol: 'AAPL230120C00155000',
+ *       ratio_qty: '1',
+ *       side: 'sell',
+ *       position_intent: 'sell_to_open',
+ *     },
+ *   ],
+ * });
+ */
+export declare function createMultiLegOptionOrder(client: AlpacaClient, params: CreateMultiLegOrderParams): Promise<AlpacaOrder>;
+/**
+ * Create a vertical spread (bull call spread or bear put spread)
+ *
+ * @param client - The AlpacaClient instance
+ * @param longSymbol - Symbol of the long leg
+ * @param shortSymbol - Symbol of the short leg
+ * @param qty - Number of spreads
+ * @param limitPrice - Net debit or credit for the spread
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ *
+ * @example
+ * // Bull call spread: buy lower strike call, sell higher strike call
+ * const order = await createVerticalSpread(
+ *   client,
+ *   'AAPL230120C00150000', // Long leg
+ *   'AAPL230120C00155000', // Short leg
+ *   5,
+ *   1.50 // Net debit
+ * );
+ */
+export declare function createVerticalSpread(client: AlpacaClient, longSymbol: string, shortSymbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Create an iron condor spread
+ *
+ * @param client - The AlpacaClient instance
+ * @param putLongSymbol - Lower strike put (buy)
+ * @param putShortSymbol - Higher strike put (sell)
+ * @param callShortSymbol - Lower strike call (sell)
+ * @param callLongSymbol - Higher strike call (buy)
+ * @param qty - Number of iron condors
+ * @param limitPrice - Net credit for the iron condor
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ *
+ * @example
+ * const order = await createIronCondor(
+ *   client,
+ *   'AAPL230120P00140000', // Buy put
+ *   'AAPL230120P00145000', // Sell put
+ *   'AAPL230120C00155000', // Sell call
+ *   'AAPL230120C00160000', // Buy call
+ *   5,
+ *   2.00 // Net credit
+ * );
+ */
+export declare function createIronCondor(client: AlpacaClient, putLongSymbol: string, putShortSymbol: string, callShortSymbol: string, callLongSymbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Create a straddle (buy both call and put at same strike)
+ *
+ * @param client - The AlpacaClient instance
+ * @param callSymbol - Call option symbol
+ * @param putSymbol - Put option symbol
+ * @param qty - Number of straddles
+ * @param limitPrice - Net debit for the straddle
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ *
+ * @example
+ * const order = await createStraddle(
+ *   client,
+ *   'AAPL230120C00150000',
+ *   'AAPL230120P00150000',
+ *   5,
+ *   6.00 // Net debit
+ * );
+ */
+export declare function createStraddle(client: AlpacaClient, callSymbol: string, putSymbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Create a strangle (buy OTM call and OTM put at different strikes)
+ *
+ * @param client - The AlpacaClient instance
+ * @param callSymbol - OTM call option symbol
+ * @param putSymbol - OTM put option symbol
+ * @param qty - Number of strangles
+ * @param limitPrice - Net debit for the strangle
+ * @param timeInForce - Time in force (default: day)
+ * @returns The created order
+ */
+export declare function createStrangle(client: AlpacaClient, callSymbol: string, putSymbol: string, qty: number, limitPrice?: number, timeInForce?: TimeInForce): Promise<AlpacaOrder>;
+/**
+ * Close an option position
+ *
+ * @param client - The AlpacaClient instance
+ * @param symbol - Option contract symbol
+ * @param options - Optional close parameters
+ * @returns The close order
+ * @throws Error if position not found or close fails
+ *
+ * @example
+ * // Close entire position with market order
+ * const order = await closeOptionPosition(client, 'AAPL230120C00150000');
+ *
+ * @example
+ * // Close partial position with limit order
+ * const order = await closeOptionPosition(client, 'AAPL230120C00150000', {
+ *   qty: 2,
+ *   limitPrice: 3.00,
+ * });
+ */
+export declare function closeOptionPosition(client: AlpacaClient, symbol: string, options?: CloseOptionPositionParams): Promise<AlpacaOrder>;
+/**
+ * Close all option positions
+ *
+ * @param client - The AlpacaClient instance
+ * @returns Result containing orders and any failures
+ *
+ * @example
+ * const result = await closeAllOptionPositions(client);
+ * console.log(`Closed ${result.orders.length} positions`);
+ * if (result.failed.length > 0) {
+ *   console.log(`Failed to close: ${result.failed.map(f => f.symbol).join(', ')}`);
+ * }
+ */
+export declare function closeAllOptionPositions(client: AlpacaClient): Promise<CloseAllOptionsResult>;
+/**
+ * Exercise an option contract
+ * Note: Exercise is only available for American-style options before expiration
+ *
+ * @param client - The AlpacaClient instance
+ * @param symbol - Option contract symbol
+ * @param qty - Number of contracts to exercise (defaults to full position)
+ * @throws Error if exercise fails
+ *
+ * @example
+ * // Exercise all contracts in position
+ * await exerciseOption(client, 'AAPL230120C00150000');
+ *
+ * @example
+ * // Exercise specific quantity
+ * await exerciseOption(client, 'AAPL230120C00150000', 5);
+ */
+export declare function exerciseOption(client: AlpacaClient, symbol: string, qty?: number): Promise<void>;
+/**
+ * Check if an option order is in a terminal state
+ *
+ * @param status - The order status
+ * @returns True if the order is in a terminal state
+ */
+export declare function isOptionOrderTerminal(status: OrderStatus): boolean;
+/**
+ * Check if an option order can be canceled
+ *
+ * @param status - The order status
+ * @returns True if the order can be canceled
+ */
+export declare function isOptionOrderCancelable(status: OrderStatus): boolean;
+declare const _default: {
+    createOptionOrder: typeof createOptionOrder;
+    buyToOpen: typeof buyToOpen;
+    sellToClose: typeof sellToClose;
+    sellToOpen: typeof sellToOpen;
+    buyToClose: typeof buyToClose;
+    validateMultiLegOrder: typeof validateMultiLegOrder;
+    createMultiLegOptionOrder: typeof createMultiLegOptionOrder;
+    createVerticalSpread: typeof createVerticalSpread;
+    createIronCondor: typeof createIronCondor;
+    createStraddle: typeof createStraddle;
+    createStrangle: typeof createStrangle;
+    closeOptionPosition: typeof closeOptionPosition;
+    closeAllOptionPositions: typeof closeAllOptionPositions;
+    exerciseOption: typeof exerciseOption;
+    isOptionOrderTerminal: typeof isOptionOrderTerminal;
+    isOptionOrderCancelable: typeof isOptionOrderCancelable;
+};
+export default _default;
+//# sourceMappingURL=orders.d.ts.map

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

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