@adaptic/utils 0.0.383 → 0.0.901

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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"}

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

@@ -0,0 +1,224 @@
+/**
+ * Options Strategies Module
+ * Build and execute common option strategies using Alpaca SDK
+ */
+import { AlpacaClient } from "../client";
+import { AlpacaOrder, TimeInForce } from "../../types/alpaca-types";
+/**
+ * Error class for option strategy operations
+ */
+export declare class OptionStrategyError extends Error {
+    code: string;
+    strategy?: string | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, strategy?: string | undefined, details?: unknown | undefined);
+}
+/**
+ * Parameters for creating a vertical spread (call or put spread)
+ */
+export interface VerticalSpreadParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Option type: call or put */
+    type: "call" | "put";
+    /** Strike price for the long leg */
+    longStrike: number;
+    /** Strike price for the short leg */
+    shortStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Debit = buy spread, Credit = sell spread */
+    direction: "debit" | "credit";
+    /** Optional limit price for the spread (net debit or credit) */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating an iron condor
+ */
+export interface IronCondorParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price for the long put (lowest strike) */
+    putLongStrike: number;
+    /** Strike price for the short put */
+    putShortStrike: number;
+    /** Strike price for the short call */
+    callShortStrike: number;
+    /** Strike price for the long call (highest strike) */
+    callLongStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Optional limit price for the spread (net credit) */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a straddle
+ */
+export interface StraddleParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price (same for both call and put) */
+    strike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Long = buy both options, Short = sell both options */
+    direction: "long" | "short";
+    /** Optional limit price for the spread */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a covered call
+ */
+export interface CoveredCallParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price for the call option */
+    strike: number;
+    /** Number of contracts (each contract = 100 shares) */
+    qty: number;
+    /** Optional limit price for the call option */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for rolling an option position
+ */
+export interface RollPositionParams {
+    /** Current option contract symbol to close */
+    currentSymbol: string;
+    /** New expiration date in YYYY-MM-DD format */
+    newExpirationDate: string;
+    /** New strike price */
+    newStrike: number;
+    /** Option type: call or put */
+    type: "call" | "put";
+    /** Optional limit price for the roll (net debit or credit) */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a strangle
+ */
+export interface StrangleParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Strike price for the put option (lower strike) */
+    putStrike: number;
+    /** Strike price for the call option (higher strike) */
+    callStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Long = buy both options, Short = sell both options */
+    direction: "long" | "short";
+    /** Optional limit price for the spread */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Parameters for creating a butterfly spread
+ */
+export interface ButterflySpreadParams {
+    /** Underlying stock symbol */
+    underlying: string;
+    /** Expiration date in YYYY-MM-DD format */
+    expirationDate: string;
+    /** Option type: call or put */
+    type: "call" | "put";
+    /** Lower strike price */
+    lowerStrike: number;
+    /** Middle strike price (usually ATM) */
+    middleStrike: number;
+    /** Upper strike price */
+    upperStrike: number;
+    /** Number of contracts */
+    qty: number;
+    /** Optional limit price for the spread */
+    limitPrice?: number;
+    /** Time in force for the order */
+    timeInForce?: TimeInForce;
+}
+/**
+ * Build an OCC-compliant option symbol
+ * Format: ROOT + YYMMDD + C/P + Strike (8 digits with 3 decimals)
+ */
+export declare function buildOptionSymbol(underlying: string, expirationDate: string, type: "call" | "put", strike: number): string;
+/**
+ * Create a vertical spread (call or put spread)
+ * - Bull Call Spread: Buy lower strike call, sell higher strike call
+ * - Bear Call Spread: Sell lower strike call, buy higher strike call
+ * - Bull Put Spread: Sell higher strike put, buy lower strike put
+ * - Bear Put Spread: Buy higher strike put, sell lower strike put
+ */
+export declare function createVerticalSpread(client: AlpacaClient, params: VerticalSpreadParams): Promise<AlpacaOrder>;
+/**
+ * Create an iron condor
+ * Combines a bull put spread and a bear call spread
+ * - Buy put at putLongStrike (lowest)
+ * - Sell put at putShortStrike
+ * - Sell call at callShortStrike
+ * - Buy call at callLongStrike (highest)
+ */
+export declare function createIronCondor(client: AlpacaClient, params: IronCondorParams): Promise<AlpacaOrder>;
+/**
+ * Create a straddle (buy/sell both call and put at same strike)
+ * - Long straddle: Buy call and put at same strike (expects high volatility)
+ * - Short straddle: Sell call and put at same strike (expects low volatility)
+ */
+export declare function createStraddle(client: AlpacaClient, params: StraddleParams): Promise<AlpacaOrder>;
+/**
+ * Create a covered call
+ * - Buy (or already own) 100 shares per contract
+ * - Sell call option against the shares
+ */
+export declare function createCoveredCall(client: AlpacaClient, params: CoveredCallParams): Promise<{
+    stockOrder: AlpacaOrder;
+    optionOrder: AlpacaOrder;
+}>;
+/**
+ * Roll an option position to a new expiration/strike
+ * Closes the current position and opens a new one
+ */
+export declare function rollOptionPosition(client: AlpacaClient, params: RollPositionParams): Promise<AlpacaOrder>;
+/**
+ * Create a strangle (buy/sell call and put at different strikes)
+ * - Long strangle: Buy OTM call and OTM put (expects high volatility)
+ * - Short strangle: Sell OTM call and OTM put (expects low volatility)
+ */
+export declare function createStrangle(client: AlpacaClient, params: StrangleParams): Promise<AlpacaOrder>;
+/**
+ * Create a butterfly spread
+ * - Long butterfly: Buy 1 lower, sell 2 middle, buy 1 upper
+ * - Expects price to stay near middle strike
+ */
+export declare function createButterflySpread(client: AlpacaClient, params: ButterflySpreadParams): Promise<AlpacaOrder>;
+declare const _default: {
+    buildOptionSymbol: typeof buildOptionSymbol;
+    createVerticalSpread: typeof createVerticalSpread;
+    createIronCondor: typeof createIronCondor;
+    createStraddle: typeof createStraddle;
+    createCoveredCall: typeof createCoveredCall;
+    rollOptionPosition: typeof rollOptionPosition;
+    createStrangle: typeof createStrangle;
+    createButterflySpread: typeof createButterflySpread;
+};
+export default _default;
+//# sourceMappingURL=strategies.d.ts.map

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

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