StraddleAI — User Guide

⚡

What is StraddleAI?

The big picture

🤖 An AI-powered NSE F&O signal agent

StraddleAI connects to Zerodha Kite every 15 minutes during market hours, fetches live option chain data for NIFTY/BANKNIFTY, runs it through Groq AI (Llama 3.1), and generates a complete options trading signal with exact strikes, entry price, stop loss, target, and rationale — delivered to your phone via Telegram automatically.

What it does for you

Monitors the market every 15 min → Finds the best options opportunity → Tells you exactly what to buy/sell, at what price, where to stop, and why → You decide whether to execute.

What it does NOT do

It does not place orders automatically. You always execute on Kite manually. The agent is your analyst, not your trader.

📅

Your daily routine

What happens each trading day

9:00 AM IST

Auto-login runs — Kite token refreshes automatically via cron. No action needed.

9:10 AM IST

Open StraddleAI app → enter PIN → go to Scan tab → tap ◉ Start Auto-Watch

9:15 AM IST

Market opens — first scan runs automatically. Signal arrives on Telegram within 30 seconds.

Every 15 min

Auto-scan — agent scans NSE data, runs AI analysis, sends Telegram signal if confidence is high.

When signal arrives

Review signal → check rationale → if confident, execute on Kite → log in app → paper trade auto-logged.

3:15 PM IST

Paper trades auto-close — all open paper positions close at current price for EOD P&L.

3:30 PM IST

Auto-Watch stops — market closes, scanning stops automatically.

🟢

Status bar explained

What the pills mean

Status pills — top of every screen

● OPEN GROQ ✓ TELEGRAM ✓ WATCH ON PAPER MODE

● OPEN / CLOSED — NSE market status. Green = market is open, signals are active.

GROQ ✓ — AI engine is connected and working. If ✗ — signals won't generate.

TELEGRAM ✓ — Notifications are working. If — , check your bot token.

WATCH ON/OFF — Auto-scan status. Must be ON for automatic signals during market hours.

PAPER MODE — Virtual trading is active. Signals are being auto-logged as paper trades.

Common issue

If pills show no colors or no ✓ — the app can't reach the server. Check your internet connection. If on mobile data, the server may be temporarily unreachable.

📱

All 7 tabs explained

What each tab does

⌂

Scan

Generate signals, view live snapshot, option chain, OI walls. Your main control panel.

📈

Charts

Market regime gauges, OI buildup chart, intraday candles, IV skew, expected move.

⚡

Signals

All AI-generated signals with full details. Log executions and add journal notes here.

◈

Open

Your manually logged open positions with SL, target and close button.

🏦

Holdings

Live F&O positions and equity holdings pulled directly from Zerodha Kite.

₹

P&L

Trade history, P&L bar chart, strategy breakdown doughnut, win rate stats.

🔧

Tools

Four powerful tools in one tab:
📓 Trade Journal — add notes to any signal, record lessons
🧮 Risk Calculator — compute max risk, P&L, breakeven for any strategy
📅 Event Calendar — upcoming RBI, FOMC, expiry dates
🎮 Paper Trading — virtual portfolio to test signals before real money

⚡

Reading a signal

Every field explained

#12 · NIFTY · 04 Jun 2026 · 10:30 AM

BULLISH

Confidence 74%

DEBIT SPREAD IV MEDIUM

Entry

₹42–48 debit

R:R

1 : 2.1

Stop Loss

₹25 net

Target

₹88 net

Strategy — Bull Call Spread

▲ BUY 24400 CE · qty 75

▼ SELL 24500 CE · qty 75

→

BULLISH / BEARISH / NEUTRAL / AVOID — the AI's directional call. AVOID means skip this signal.

→

Confidence % — how certain the AI is. >70% = high confidence. <50% = skip or paper trade only.

→

Entry ₹42–48 debit — the net premium you pay when placing both legs on Kite. Aim to execute within this range.

→

Stop Loss ₹25 — if the spread value falls to ₹25, exit immediately to limit loss.

→

Target ₹88 — when spread reaches ₹88, take profit.

→

R:R 1:2.1 — for every ₹1 you risk, potential to make ₹2.1. Look for R:R above 1.5.

→

Legs — exact strikes to BUY and SELL on Kite's option chain. Both legs = one spread position.

✅

How to execute a trade

Step by step

On Kite (real money)

Open Kite app → search for the instrument (e.g. NIFTY)

Go to Option Chain → select the expiry from the signal

BUY the lower strike CE (e.g. 24400 CE) — note the premium

SELL the higher strike CE (e.g. 24500 CE) — note the premium

Calculate net debit = buy price − sell price. Should be within entry range.

Back in StraddleAI → Signals tab → tap ✅ Executed → enter net premium

Position appears in Open tab for monitoring

Closing a position

When target or stop is hit — go to Open tab → tap 🔒 Close → enter exit premium → P&L is calculated automatically and added to your history.

🎮

Paper trading guide

Test before real money

What is paper trading?

Paper trading tracks signals as virtual trades — no real money, no Kite execution needed. Every signal you generate is automatically logged with your entry price. At end of day (3:15 PM) all open paper trades auto-close. After 4 weeks you'll have clear data on the agent's real performance.

How to use it

Go to 🔧 Tools tab → scroll to Paper Trading → tap Enable

PAPER MODE pill appears in top bar — purple

Generate any signal → it's automatically logged as a paper trade

Monitor virtual P&L, trade count, win rate in the Tools tab

Paper trades auto-close at 3:15 PM or when target/stop is hit

After 4 weeks — check win rate → if >55% go live with real money

Recommended approach

Paper trade for at least 4 weeks before real money. Look for win rate above 55% and average R:R above 1.5. Track which strategies (Bull Spread, Iron Condor etc.) work best for your instrument.

📈

Charts & gauges

Understanding the visuals

📊 Market Regime Gauges (3 dials)

IV Rank gauge — shows how high current volatility is vs its 52-week range.
Green (<30%) = low IV → buy premium (buy calls/puts or debit spreads)
Amber (30–60%) = medium IV → either strategy works
Red (>60%) = high IV → sell premium (iron condor, credit spreads)

PCR gauge — Put-Call Ratio sentiment.
PCR > 1.2 = more puts than calls = bullish signal (institutions hedging)
PCR < 0.7 = more calls than puts = bearish signal

Pain Distance — how far spot price is from Max Pain strike.
Near pain = spot likely to gravitate toward max pain
Far from pain = strong directional move underway

📉 OI Buildup Chart

Blue bars = Call OI (resistance levels) — where sellers are positioned
Red bars = Put OI (support levels) — where buyers are hedged
The strike with the longest blue bar = strongest resistance
The strike with the longest red bar = strongest support
◀ ATM = current at-the-money strike

📐 Expected Move Panel

Shows the price range the market is pricing in for the current expiry.
Calculated from the ATM straddle premium.
Upper / Lower bounds = where 68% probability of price ending up.
If spot is already near the upper bound — don't initiate bullish trades.

📖

Options glossary

Key terms explained simply

ATM	At-The-Money — the strike price closest to current spot price
CE	Call option — right to buy. Profits when market goes UP
PE	Put option — right to sell. Profits when market goes DOWN
OI	Open Interest — number of active contracts at a strike. High OI = strong level
PCR	Put-Call Ratio — total put OI ÷ total call OI. Above 1 = more bearish hedging
IV	Implied Volatility — how much movement the market is pricing in
IV Rank	Current IV vs its 52-week range. 0% = lowest ever, 100% = highest ever
Max Pain	Strike where option writers (sellers) lose least — price often gravitates here near expiry
Straddle	Buying both CE and PE at same strike. Profits from big moves in either direction
Bull Spread	Buy lower CE + Sell higher CE. Profits from moderate upward move
Bear Spread	Buy higher PE + Sell lower PE. Profits from moderate downward move
Iron Condor	Sell both a call spread and put spread. Profits when market stays range-bound
Debit	Net premium paid — maximum loss on a spread trade
Credit	Net premium received — maximum profit on a credit spread trade
Theta	Time decay — options lose value every day. Sellers benefit from theta
R:R	Risk-Reward ratio. 1:2 means risk ₹1 to potentially make ₹2
Lot	Minimum trade unit. NIFTY = 75 shares per lot, BANKNIFTY = 30
Expiry	The date the option contract expires. Weekly = every Thursday

❓

Frequently asked questions

Common questions answered

Why am I not receiving Telegram signals? ▼

Make sure Auto-Watch is ON (amber button on Scan tab). Also confirm you've sent /start to your Telegram bot. Check that TELEGRAM pill shows ✓ in green. If GROQ shows ✗ — the AI engine is down and signals won't generate.

Why does Holdings show "token expired"? ▼

Kite access tokens expire daily at midnight. The auto-login cron runs every morning at 9:00 AM IST and refreshes it automatically. If you see this error after 9 AM — the auto-login may have failed. Run `python3 kite_login.py` in SSH to manually refresh.

What does AVOID signal mean? ▼

The AI has analyzed the market but determined there is no good setup right now — either conflicting signals, very low confidence, or dangerous market conditions. No Telegram message is sent. Simply skip this cycle and wait for the next scan in 15 minutes.

How much capital do I need per trade? ▼

For a Bull Call Spread on NIFTY (1 lot = 75 shares), typical net debit is ₹40–80 per share. So capital needed = ₹40–80 × 75 = ₹3,000–6,000 per lot. Always check the Max Risk field in each signal — that's your exact worst-case loss per lot.

Should I take every signal? ▼

No. Use paper trading first to understand the agent's behavior. When going live, focus on signals with confidence above 65%, R:R above 1.5, and during calm market conditions (not during RBI/FOMC events). Check the Event Calendar in Tools tab before trading.

What happens if I don't close a position by 3:30 PM? ▼

Paper trades auto-close at 3:15 PM. For real positions on Kite — options positions automatically settle at expiry if not closed manually. For intraday MIS positions, Kite auto-squares off at 3:20 PM. Always close options positions before 3:15 PM to avoid unfavorable auto-square-off prices.

Can I use this for BANKNIFTY instead of NIFTY? ▼

Yes — on the Scan tab, change the Instrument dropdown from NIFTY to BANKNIFTY. Note that BANKNIFTY lot size is 30 (vs NIFTY's 75) and is more volatile. Start with NIFTY for paper trading as it's more predictable.

How do I know when to go live with real money? ▼

After 4 weeks of paper trading, check: Win rate above 55%, Average R:R above 1.5, Consistent signals during normal market conditions, No major losses from single bad trades. Start with 1 lot real money alongside continued paper trading. Scale up gradually.