🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

options-strategist

by @finskills

Analyze options chains, compute implied volatility rank, and select optimal multi-leg strategies based on market conditions via the Finskills API.

TERMINAL
clawhub install options-strategist

πŸ“– About This Skill


name: Options Strategist version: 1.0.2 description: "Analyze options chains, compute implied volatility rank, and select optimal multi-leg strategies based on market conditions via the Finskills API." author: finskills metadata: openclaw: requires: env: - FINSKILLS_API_KEY primaryEnv: FINSKILLS_API_KEY homepage: https://github.com/finskills/options-strategist

Options Strategist

Analyze options chains, construct multi-leg strategies, calculate Greek risk metrics, and generate structured trade recommendations using real-time options data from the Finskills API. Combines quantitative options theory with live market data to evaluate opportunity and manage risk.


Setup

API Key required β€” Register at https://finskills.net to get your free key. Header: X-API-Key: > Get your API key: Register at https://finskills.net β€” free tier available, Pro plan unlocks real-time quotes, history, and financials.


When to Activate This Skill

Activate when the user:

  • Asks which options strategy is best for a given outlook
  • Wants to analyze a specific options contract or expiration
  • Asks about Greeks (Delta, Gamma, Theta, Vega) for a position
  • Wants to build a covered call, protective put, spread, straddle, or iron condor
  • Asks about implied volatility, volatility skew, or IV rank
  • Wants to calculate break-even points or max profit/loss for a trade

  • Required Information

    Resolve before starting: 1. Underlying ticker β€” e.g., SPY, AAPL 2. Directional outlook β€” Bullish / Bearish / Neutral / Volatile / Non-volatile 3. Time horizon β€” Days to target expiration (e.g., 30, 45, 60 DTE) 4. Risk tolerance β€” Defined-risk vs. undefined-risk strategies preferred 5. Account level β€” Options approval level (Level 1–4) if known


    Data Retrieval β€” Finskills API Calls

    1. Real-Time Quote

    GET https://finskills.net/v1/stocks/quote/{SYMBOL}
    
    Extract: price (current underlying price), volume, changePercent

    2. Options Chain

    GET https://finskills.net/v1/stocks/options/{SYMBOL}
    
    Extract from each contract:
  • strike, expiration, type (call/put)
  • bid, ask, mid (use mid for pricing)
  • impliedVolatility (as decimal, multiply by 100 for %)
  • delta, gamma, theta, vega (Greeks)
  • openInterest, volume
  • inTheMoney flag
  • 3. Historical Price (for IV Rank / Realized Vol)

    GET https://finskills.net/v1/stocks/history/{SYMBOL}?period=1y&interval=1d
    
    Extract closing prices; compute:
  • HV20: 20-day historical volatility (annualized standard deviation of daily returns Γ— √252)
  • HV60: 60-day historical volatility
  • Price range: 52-week high/low for support/resistance context

  • Analysis Workflow

    Step 1 β€” Market Context

    From the quote data, note:

  • Current price vs. 52-week range (where in range?)
  • Recent price momentum (up/down trend)
  • Sector/market context (risk-on/off environment)
  • Step 2 β€” Volatility Analysis

    Using the options chain and historical data:

    Implied Volatility Metrics:

  • ATM IV: Use implied volatility of the nearest-to-ATM straddle
  • IV Rank (approximation): (Current ATM IV βˆ’ 52w Low IV) / (52w High IV βˆ’ 52w Low IV) Γ— 100
  • - IV Rank > 50: Elevated IV β†’ consider selling premium - IV Rank < 30: Low IV β†’ consider buying premium

    Volatility Skew: Compare put IV vs. call IV at equidistant strikes

  • Positive skew (puts more expensive): Market pricing downside protection
  • Flat skew: Balanced two-directional uncertainty
  • HV vs. IV Comparison:

  • IV > HV by > 20%: Premium selling opportunity (high vega)
  • IV < HV: Premium buying may be cheap
  • Step 3 β€” Strategy Selection Matrix

    Based on outlook and volatility environment:

    | Outlook | IV Environment | Recommended Strategy | |---------|----------------|---------------------| | Bullish | Low IV | Long Call, Bull Call Spread | | Bullish | High IV | Cash-Secured Put (sell put), Bull Put Spread | | Bearish | Low IV | Long Put, Bear Put Spread | | Bearish | High IV | Bear Call Spread, Covered Call | | Neutral (non-volatile) | High IV | Iron Condor, Short Strangle, Short Straddle | | Neutral (volatile) | Low IV | Long Straddle, Long Strangle | | Mildly Bullish | High IV | Covered Call, Bull Put Spread | | Hedge existing long | Any | Protective Put, Collar |

    Always prefer defined-risk strategies unless user explicitly requests undefined risk.

    Step 4 β€” Strike and Expiration Selection

    Expiration guidelines:

  • Income strategies (iron condor, credit spreads): 30–45 DTE (optimal theta decay)
  • Directional strategies (debit spreads): 45–90 DTE (time buffer)
  • Long options (earnings plays, catalysts): 1–2 weeks past the event
  • Strike selection guidelines:

  • Delta guide: Long calls/puts: 0.30–0.50 delta for balanced risk/reward
  • Credit spreads: Sell at 0.25–0.35 delta (β‰ˆ 70–75% probability of profit)
  • Iron condor wings: 0.15–0.20 delta for outer strikes
  • ATM for straddles/strangles: Use the nearest strike(s) to current price
  • Step 5 β€” Strategy Metrics Calculation

    For the recommended strategy (manual calculation using API data):

    For Debit Spreads (e.g., Bull Call Spread):

    Max Profit  = (Width of spread βˆ’ Net debit) Γ— 100
    Max Loss    = Net debit Γ— 100
    Break-Even  = Long strike + Net debit paid
    ROI at max  = Max Profit / Max Loss Γ— 100%
    

    For Credit Spreads (e.g., Bull Put Spread):

    Max Profit  = Net credit received Γ— 100
    Max Loss    = (Width of spread βˆ’ Net credit) Γ— 100
    Break-Even  = Short strike βˆ’ Net credit received
    Probability of Profit β‰ˆ 1 βˆ’ short put delta (as %)
    

    For Iron Condors:

    Max Profit  = Total net credit Γ— 100
    Max Loss    = (Width of widest wing βˆ’ Total credit) Γ— 100
    Lower B/E   = Short put strike βˆ’ Total credit
    Upper B/E   = Short call strike + Total credit
    

    Greeks for the position:

  • Position Delta: Net sum of (leg delta Γ— lots Γ— sign)
  • Position Theta: Net sum of (leg theta Γ— lots Γ— sign) β€” daily P&L from time decay
  • Position Vega: Net sum β€” how much P&L changes per 1% IV move
  • Step 6 β€” Risk Management Rules

    Always state: 1. Max loss cap: Risk no more than 2–5% of portfolio per trade 2. Exit at 50% max profit (for credit strategies): Lock in profit, reinvest theta 3. Exit at 2Γ— max credit (stop-loss): Close if spread doubles in value against you 4. Adjust or roll if: Underlying breaches short strike by more than 1 strike width 5. Earnings blackout: Close or roll before earnings if not intentionally an earnings play


    Output Format

    ╔══════════════════════════════════════════════════════╗
    β•‘     OPTIONS STRATEGY REPORT β€” {TICKER} ({DATE})     β•‘
    β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

    πŸ“Œ UNDERLYING {Ticker}: ${price} Change: {%} Outlook: {Bullish/Bearish/Neutral}

    πŸ“Š VOLATILITY ENVIRONMENT ATM IV: {%} IV Rank: {0–100} β†’ {Low/Elevated/High} HV20: {%} HV60: {%} IV vs HV: {premium/discount} Skew: {Positive/Flat/Negative} β€” {one-line interpretation} Recommendation: {Sell premium / Buy premium}

    🎯 RECOMMENDED STRATEGY: {STRATEGY NAME}

    Structure: Leg 1: {BUY/SELL} {qty} {TICKER} {Strike} {Exp} {CALL/PUT} @ ${price} Leg 2: {BUY/SELL} {qty} {TICKER} {Strike} {Exp} {CALL/PUT} @ ${price} [Additional legs if applicable]

    Net {Debit/Credit}: ${amount} per contract

    πŸ“ Key Metrics: Max Profit: ${amount} ({%} ROI) Max Loss: ${amount} Break-Even: ${price} [{direction} from current] Prob of Profit: {%} Days to Exp: {DTE} days

    πŸ“‰ Position Greeks (per contract): Delta: {value} Gamma: {value} Theta: {value}/day Vega: {value}

    πŸ’Ό Risk Management: βœ“ Profit target: Close at 50% max profit (${amount} credit remaining) βœ“ Stop-loss: Close if debit/spread reaches ${amount} (2Γ— initial credit) βœ“ Time exit: Close or roll at 21 DTE to avoid gamma risk

    πŸ“‹ ALTERNATIVE STRATEGIES CONSIDERED {Alternative 1}: {brief rationale for/against} {Alternative 2}: {brief rationale for/against}

    ⚠️ KEY RISKS β€’ {Risk 1 β€” e.g., earnings announcement within DTE, sudden vol crush} β€’ {Risk 2 β€” e.g., gap risk if undefined risk}


    Limitations

  • Options chain data reflects last available bid/ask; actual fills may differ.
  • IV Rank is approximated from available chain data, not full 52-week option history.
  • Greeks calculations assume no dividends or early assignment unless noted.
  • This is not personalized financial advice; consult a licensed advisor before trading options.
  • βš™οΈ Configuration

    API Key required β€” Register at https://finskills.net to get your free key. Header: X-API-Key: > Get your API key: Register at https://finskills.net β€” free tier available, Pro plan unlocks real-time quotes, history, and financials.