Advanced Algorithmic Trading

🦅 Eagle Alpaca Suite

Complete Technical Reference for Automated Options Strategies

--real

Executes against the LIVE account. Defaults to Paper Trading.

--dry-run

Simulates execution without submitting orders to Alpaca.

--json

Outputs results in raw JSON format for scripting and integration.

--debug

Shows detailed DEBUG logs, including API requests and connection pools.

Iron Condor Strategy

screener.py

Analysis

Finds tickers where Implied Volatility (IV) is significantly higher than Historical Volatility (HV), creating a statistical "Edge."

FlagDescription
--tickersSpecific symbols (AAPL,TSLA) or 'universe' (default).
--widthSpread width for ROI calculation (Default: 5.0).
--min-liquidityMinimum liquidity score to include (Default: 50.0).

analyze.py

Deep-Dive

Quantitative deep-dive on a specific ticker. Calculates skew-adjusted strikes, POP, and recommends an execution command.

FlagDescription
--tickerRequired. The underlying symbol to analyze.

condor.py

Execution

Deploys a 4-leg Iron Condor multi-leg order. Logs all entry context (IV, HV, Skew) to the database.

FlagDescription
--tickerRequired. Symbol to trade.
--movePercentage distance for short strikes (Default: 0.05).
--widthSpread width for both wings (Default: 5.0).
--qtyNumber of Iron Condor packages (Default: 1).
--min_creditMinimum net credit to accept (Default: 0.05).

The Wheel Strategy

wheel_screen.py

Screens for Cash Secured Put (CSP) candidates based on budget and Annualized ROI.

FlagDescription
--budgetMax collateral allowed for a single position.
--tickersSpecific list or 'universe'.

wheel_executor.py

Executes single-leg Put or Call sales. Verifies collateral or share ownership before submission.

FlagDescription
--tickerUnderlying symbol.
--symbolThe exact OCC option symbol.
--mode'put' (Cash Secured) or 'call' (Covered).
--priceLimit price per contract.

Bull Call Strategy

bull_call_analyze.py

Analyzes vertical debit spreads. Checks for "Bullish Sentiment" and verifies if the spread fits within your net debit budget.

FlagDescription
--longStrike price of the call you are buying.
--shortStrike price of the call you are selling.
--dte_minMinimum days to expiration (Default: 30).
--dte_maxMaximum days to expiration (Default: 45).
--budgetMax net debit allowed per contract (Default: 2.50).

Portfolio Monitoring

monitor.py

A real-time terminal dashboard. Refreshes every 10s.

  • Displays Net Greeks (Delta, Theta).
  • Shows total Unrealized P&L.
  • Fix: Stock positions are auto-filtered to prevent API errors.

arm_play.py

Highly specialized monitor for the ARM directional play.

  • Probability of finishing ITM.
  • Expiration and DTE Countdown.
  • Liquidation analysis (immediate cash impact).

Account & Utility

account.py

Quick snapshot of account health, cash balance, and margin requirements.

close.py

Emergency exit script. Closes specific symbols or entire spreads immediately at market price.

FlagDescription
--symbolSpecific OCC symbol to close.
--allClose all open positions in the account.