Help & reference
Every setting in ACondor has a corresponding help page. When you click the ? tooltip inside the bot's dashboard, it links directly here. These pages document what each setting does, the safe range, and the default value.
System Reference
How ACondor finds and scores candidates every 3 minutes
The default iron condor engine. IV Rank ≥ 50, 30-65 DTE
IV-crush plays: enter before earnings, exit the morning after
Non-earnings vol spikes: short-dated defined-risk positions
Bias-driven debit structures funded by credit spreads. Off by default.
Settings reference
Allocation & Position Sizing
- Max Allocation % 10%max_allocation_pct
- Max Allocation Dollars not setmax_allocation_dollars
- max_buying_power_pct
- beta_delta_gate_enabled
- beta_delta_band_pct
- max_concurrent_positions
- max_new_entries_per_cycle
- max_positions_per_sector
- contracts_per_position
- account_nlv
- loop_interval_seconds
- Entries Paused OFFentries_paused
Risk & Circuit Breakers
- kill_switch_vix_level
- Max Daily Loss Dollars -$500max_daily_loss_dollars
- Max Daily Loss % -5%max_daily_loss_pct
- Max Weekly Loss Dollars -$1,500max_weekly_loss_dollars
- Max Weekly Loss % -10%max_weekly_loss_pct
- Max Loss Per Trade dollars ($700 flat cap)max_loss_per_trade_mode
- Risk-Off Index Drop % -1.5%risk_off_index_drop_pct
- Risk-Off VIX Intraday Jump 5 pointsrisk_off_vix_intraday_jump
- exit_warmup_minutes
- expiry_close_profit_min_pct
Mechanical Engine
- mechanical_target_dte_min
- mechanical_target_dte_max
- mechanical_short_strike_delta
- mechanical_profit_target_pct
- mechanical_spread_width
- mechanical_min_iv_rank
- Mechanical Min Score 0.25mechanical_min_score
- mechanical_prefer_monthly_expiry
- mechanical_enabled
- mechanical_manage_dte
- iron_condor_enabled
- put_credit_spread_enabled
- call_credit_spread_enabled
- short_strangle_enabled
- short_put_enabled
- naked_put_enabled
- bullish_pair_call_spread_enabled
- bearish_pair_put_spread_enabled
- engine_max_alloc_pct_mechanical
- Mechanical Engine: Max Positions not setengine_max_positions_mechanical
Earnings Engine
- earnings_entry_trigger_iv_rank
- earnings_target_dte_min
- earnings_target_dte_max
- earnings_entry_max_days_before_earnings
- earnings_defined_risk_short_delta
- earnings_spread_width
- Earnings Naked Symbols {} (empty)earnings_naked_symbols
- earnings_enabled
- engine_max_alloc_pct_earnings
- Earnings Engine: Max Positions not setengine_max_positions_earnings
Contraction Engine
- contraction_entry_iv_rank
- contraction_require_iv_rank_jump
- contraction_target_dte_min
- contraction_target_dte_max
- contraction_short_strike_delta
- contraction_iv_normalized_rank
- contraction_manage_dte
- contraction_enabled
- contraction_profit_target_pct
- Contraction News Entry Confidence Threshold HIGH (0.80)contraction_news_entry_confidence_threshold
- contraction_news_entry_lookback_hours
- contraction_news_entry_profit_target_pct
- engine_max_alloc_pct_contraction
- engine_max_positions_contraction
Directional Engine
- directional_enabled
- directional_target_dte_min
- directional_target_dte_max
- directional_profit_target_pct
- directional_delta_take_profit
- directional_loss_pct_of_premium
- directional_manage_dte
- directional_min_iv_rank
- directional_min_reward_risk
- directional_swing_mode
- directional_max_iv_rank
- directional_funded_pair_bonus
- directional_long_penalty
- directional_funded_pair_max_debit_pct
- bull_call_spread_enabled
- bear_put_spread_enabled
- bullish_pair_call_enabled
- bearish_pair_put_enabled
- long_call_enabled
- long_put_enabled
- engine_max_alloc_pct_directional
- engine_max_positions_directional
- directional_contracts_per_position
- chain_skew_threshold
- strong_chain_skew_threshold
- require_strong_bias_for_directional
Roll Settings
- roll_enabled
- Roll To DTE 45roll_to_dte
- roll_max_rolls
- Roll Fee Buffer $0.25roll_fee_buffer
- Ladder Defend Delta 0.45ladder_defend_delta
- ladder_defend_move_ratio
- vertical_roll_enabled
Profit Ladder
- mechanical_profit_ladder_enabled
- earnings_profit_ladder_enabled
- contraction_profit_ladder_enabled
News Gate
- news_gate_enabled
- news_confidence_threshold_close
- news_confidence_threshold_reduce
- News Flag Confidence 0.60news_confidence_threshold_flag
- news_gate_min_move_pct
- news_gate_min_hold_minutes
- contraction_news_entry_enabled
- news_trigger_enabled
Execution
- stale_order_max_age_minutes
- order_retry_attempts
- entry_wait_after_open_minutes
- entry_stop_before_close_minutes
- sandbox_use_market_close
- order_retry_base_delay_seconds
- known_liquid_symbols
- mechanical_pop_floor_enabled
- mechanical_pop_floor_value
- earnings_pop_floor_enabled
- earnings_pop_floor_value
- contraction_pop_floor_enabled
- contraction_pop_floor_value
Notifications
- notifications
- SMS Enabled OFFsms_enabled
- sms_to_number
- SMS On Entry OFFsms_on_entry
- SMS On Exit OFFsms_on_exit
- SMS On Halt OFFsms_on_halt
- pushover_api_token
- pushover_user_key
- pushover_on_entry
- pushover_on_exit
- pushover_on_halt
- pushover_priority
Accounts
- oauth_refresh_token
- oauth_refresh_token
- oauth_refresh_token
- account_nickname
- account_type
- account_dry_run
- account_trading_enabled
- tt_sandbox_secret
- tt_live_secret
- anthropic_api_key
- Anthropic API Base URL https://api.anthropic.comanthropic_api_base_url
- News Classifier Model claude-haiku-4-5-20251001news_classifier_model
- tradingnews_api_key
- TradingNews WebSocket URL wss://api.tradingnews.press/v1/streamtradingnews_ws_url
- account_reset
Concepts glossary
- Days to Expiration (DTE)
DTE is the number of calendar days remaining until an option contract expires. A 30 DTE option expires in 30 calendar days. Options lose time value (theta) as DTE decreases, accelerating in the final 21 days. ACondor's mechanical engine targets 30-65 DTE at entry, long enough that theta is meaningful but short enough that the position resolves in roughly one to nine weeks. The bot's management rules are also DTE-anchored: the mechanical engine closes at 21 DTE regardless of profit, because the theta-to-gamma tradeoff degrades past that point.
- IV Rank
IV Rank measures where current implied volatility sits relative to its own trailing 52-week range. Formula: (IV_now minus IV_52wk_low) divided by (IV_52wk_high minus IV_52wk_low) times 100. An IV Rank of 0 means vol is at the bottom of its annual range. An IV Rank of 100 means it is at the top. ACondor only sells premium when IV Rank meets its engine-specific floor: 50 for the mechanical and earnings engines, 80 for contraction. Each floor is adjustable per account from the dashboard. Selling at low IV Rank means collecting thin premium for the same risk. The edge disappears.
- Iron Condor
An iron condor is a four-leg options structure. You sell an out-of-the-money put (the short put), buy a put further below it (the long put wing), sell an out-of-the-money call (the short call), and buy a call further above it (the long call wing). The credit collected when you enter is your maximum profit. The difference between the short and long strikes (the wing width) minus the credit collected is your maximum loss. Maximum loss is defined and capped at entry: you cannot lose more than the wing width per contract regardless of how far the underlying moves. ACondor's mechanical engine defaults to 10-dollar-wide wings and 20-delta short strikes, with the width selectable per account in $5 increments (5, 10, 15, or 20). At those parameters, a 10-wide iron condor collecting $3.00 credit has max profit $300 and max loss $700 per contract.
- Delta
Delta is one of the options Greeks. Two practical interpretations: as a hedge ratio, a 0.30-delta option moves approximately $0.30 for every $1 move in the underlying. As a probability approximation, a 0.30-delta option has approximately a 30% chance of finishing in-the-money at expiration (70% chance of expiring worthless). ACondor uses delta as a probability filter at entry. For the contraction engine, 16-delta shorts place the strikes at approximately one standard deviation OTM, with roughly 84% probability of expiring worthless.
- Probability of Profit
POP is the modeled probability that a position closes at any profit at expiration. ACondor calculates POP conservatively as 1 minus the sum of the absolute values of the short deltas. For a 30-delta iron condor: POP = 1 - 0.30 - 0.30 = 0.40. This is stricter than tastytrade's wider POP that includes the credit cushion to breakeven. The POP floor in each engine is shipped disabled by default precisely because this conservative metric would reject most default condors if set too high.
- Theta
Theta is the rate at which an option loses value as time passes, all else equal. Premium sellers collect positive net theta. Theta accelerates in the final weeks before expiration, which is why ACondor closes mechanical trades at 21 DTE. At that point, gamma risk (the rate at which delta changes) begins to outpace the remaining theta benefit, and holding into expiration becomes a lottery rather than an edge.
- Vega
Vega measures an option's sensitivity to a 1-point change in implied volatility. Short premium positions are short vega: they profit when IV falls. The earnings and contraction engines are specifically designed to harvest vega contraction: enter when IV is elevated, exit when IV has mean-reverted. The mechanical engine benefits from vega less directly, relying more on theta decay over its 30-65 DTE window.
- Implied Volatility
Implied volatility is the volatility the market is pricing into options. Realized volatility is what actually happens. The structural edge in premium selling is that IV tends to overstate realized vol, especially when IV Rank is elevated. ACondor's mechanical engine requires IV Rank at or above 50 to ensure the bot only sells when premium is elevated relative to that name's own history.
- Credit Spread
A credit spread is a two-leg vertical: sell a closer-to-the-money option, buy a further OTM option of the same type. You collect a credit on entry. The long wing caps your maximum loss. Iron condors are two credit spreads on opposite sides of price. ACondor's mechanical engine enters iron condors by default; when a directional bias exists, it may enter a single-sided credit spread instead.
- Debit Spread
A debit spread is a two-leg vertical: buy a closer-to-the-money option, sell a further OTM option of the same type. You pay a debit on entry and bet on direction. Defined risk by construction. The directional engine uses debit spreads, often funded by an offsetting credit spread (a pair structure). The profit target is 82% of max profit.
- Short Strangle
A short strangle is a two-leg undefined-risk structure: sell an OTM put and sell an OTM call. It collects more premium than an iron condor but has undefined loss. ACondor restricts strangles to margin accounts and uses defined-risk variants in IRAs and cash accounts. SPY, QQQ, IWM, and XLF are restricted to defined-risk-only regardless of account type, because a naked index ETF position represents very large correlated notional exposure.
- IV Crush
IV Crush is the rapid drop in implied volatility after a known event resolves, most commonly an earnings report. The market prices in event uncertainty beforehand; once the event passes, uncertainty disappears and IV collapses. The earnings engine harvests this collapse: enter when IV inflates above IV Rank 50, hold through the report, exit the morning after when the crush has occurred and the edge is spent.
- Rolling a Position
Rolling means closing one position and opening another, usually further out in time or further OTM, often as a single combined order. ACondor's roll ladder rolls tested short strikes out in time for a net credit when the trigger delta (0.45) is reached. Rolling buys time and reduces cost basis but does not cap loss: the wing on the defined-risk structure already does that. ACondor follows tastytrade's guidance: roll_defined_risk is OFF by default. Rolls require a minimum net credit of $0.25 per contract (roll_fee_buffer); otherwise the position closes.
- Defined vs Undefined Risk
A defined-risk structure has a known maximum loss capped by a long option wing. Iron condors, credit spreads, and debit spreads are all defined-risk. An undefined-risk structure (naked options, short strangles) has theoretically unlimited loss on the call side. ACondor enforces defined-risk-only in IRA and cash accounts automatically. In margin accounts, undefined-risk is off by default for all engines and must be explicitly enabled per-symbol.
Financial Information Disclaimer
This site provides general information about ACondor, a software tool for automating options trading strategies. Nothing on this site is investment, tax, or financial advice. Options trading involves substantial risk of loss. Past behavior of any strategy does not guarantee future results. Consult a licensed financial professional before trading options. ACondor may earn a commission from affiliate links at no extra cost to you.