Most Indian retail traders are leaving an enormous analytical edge on the table. You already pay brokerage to ICICI Direct, Zerodha, or Upstox. You already receive exchange-licensed data through those accounts. But you use almost none of that data beyond the broker's own mobile app.
Behind every major Indian broker sits a free (or near-free) programming interface — an API — that exposes everything the broker app shows you, plus 3-10 years of historical data, live option chains with Greeks, full portfolio positions, and real-time WebSocket streams. All of it, for free, as long as the data flows into your own account on your own device.
This guide walks through exactly how to connect your broker API to White Stallion AI — a free browser-based wealth command centre built specifically for Indian F&O traders — to unlock live portfolio analysis, strategy backtesting, and real-time margin calculations that would otherwise cost ₹24,000 to ₹27 lakh per year from third-party data vendors.
1. What is a broker API and why should retail traders care?
Every serious retail trader in India eventually hits the same wall: you have a good trading idea, but you don't have the tools to test it properly. The broker app shows you a chart. It lets you place orders. But when you want to understand why your covered call lost ₹18,000 last month, or whether that iron condor you're building will actually be profitable at expiry — the broker app stops being enough.
This is exactly where a broker API comes in, and this is exactly where most retail traders never realize they already have access to extraordinary tools.
The broker API in plain language
A broker API — short for "Application Programming Interface" — is a secure channel your broker exposes that lets authorized external applications talk to your trading account. When you authorize White Stallion AI (or any API-enabled platform) to use your Zerodha, ICICI, Upstox, or Angel One account via the API, you give it read-only (or read-write, depending on scope) access to:
- Your live portfolio positions — what you hold, at what average price, current P&L
- Your open orders — pending, executed, cancelled, modified
- Real-time market data — live LTP (last traded price), bid/ask, volume
- Historical OHLC candles — often 3 to 10 years of per-minute data
- Option chain snapshots — full strike-by-strike data with Greeks, OI, IV
- Trade history — every executed trade with timestamps, prices, brokerage
Unlike screen scraping or manual CSV imports, API data flows in real-time, cleanly, with the exchange's own accuracy stamp — because your broker is a SEBI-licensed data consumer.
💡 The hidden economics
If you're already paying brokerage to a broker like ICICI Direct, Zerodha, or Upstox, you've effectively already paid for the data feed — you just aren't using it beyond the broker's own app. Most brokers now give you API access completely free, as long as you're trading your own account.
2. The broker API advantage — why this beats paid data subscriptions
Let's put numbers on the table. Here's what Indian retail traders typically pay for market data and analysis:
| Source | What you get | Annual cost | Commercial use? |
|---|---|---|---|
| NSE real-time L1 direct license | Full live feed, all instruments | ₹27,50,000+/year | Yes, restricted |
| TrueData / GDFL (NSE-authorized vendors) | Real-time L1, option chain | ₹24,000 — ₹60,000 | Limited |
| Twelve Data / Finnhub / EODHD | Global incl. NSE, various tiers | ₹18,000 — ₹40,000 | Yes on paid tiers |
| Alpha Vantage paid plans | Global + NSE daily/intraday | ₹3,000 — ₹25,000 | Yes |
| Your broker's API (Zerodha, ICICI, Upstox, Angel) | Live data + your positions + historical + option chain | ₹0 — ₹6,000 | For your account |
Read that last row again. If you are already a customer of any major Indian broker, your broker API gives you access to data that enterprise-grade vendors sell for tens of thousands of rupees a year — because as a trading-account holder, you've already paid for it via the standard brokerage fees baked into each trade.
Broker APIs are the single most underutilized resource available to Indian retail traders. Most people don't use them because they assume API access means "you need to code Python and build algorithms". That's no longer true. Platforms like White Stallion AI consume the API on your behalf and present everything in a clean, visual dashboard.
The three-way advantage
Your actual positions
Yahoo Finance, Twelve Data, NSE public pages can show you live prices. They cannot show you that you own 265 shares of INTC at an average of $42.40, or that your covered call on TITAN expires in 11 days. That personal context is only available via your broker's API — and it's exactly what analysis needs to give you advice that actually applies to your portfolio.
Exchange-grade accuracy
Broker APIs deliver data the broker itself licenses from NSE/BSE under full commercial terms. This is the same feed powering the broker's own live app and your actual order execution. No scraping, no caching artifacts, no "data as of 15 minutes ago" caveats — it is as fresh and correct as data can be in Indian markets.
Legal clarity
Using your own broker API for your own account, on any platform you trust, is unambiguous and SEBI-compliant. There's no gray zone about "is this considered commercial redistribution?" because the data never leaves your session. Very different from apps that scrape NSE's public pages or rebroadcast data without a license.
3. Complete broker API comparison — Zerodha, ICICI Breeze, Upstox, Angel One, Dhan, Fyers
Here is the honest, feature-by-feature comparison you will not find on any single broker's marketing page. Everything below is verified against each broker's official documentation as of April 2026.
| Feature | Zerodha Kite | ICICI Breeze | Upstox | Angel SmartAPI | Dhan | Fyers |
|---|---|---|---|---|---|---|
| Access tier | Free Personal / ₹500/mo Paid | Free | Free | Free | Free | Free |
| Live quotes (LTP, bid/ask) | Paid only | ✅ Free | ✅ Free | ✅ Free | ✅ Free | ✅ Free |
| Historical OHLC | Paid only | 3yrs, 1-sec | V3 API | Yes | Yes | Yes |
| F&O historical | Paid only | 3yrs free | Yes | Yes | Yes | Yes |
| Option chain + Greeks | Paid only | ✅ Free | ✅ Free | ✅ Free | ✅ Free | ✅ Free |
| Live WebSocket feed | Paid only | ✅ Free | ✅ Free | ✅ Free | ✅ Free | ✅ Free |
| Rate limit | 3/sec, 200/min | 100/min, 5k/day | 25/sec | 10/sec | 10/sec | 10/sec |
| Portfolio read | ✅ Even free tier | ✅ Free | ✅ Free | ✅ Free | ✅ Free | ✅ Free |
| SDK coverage | Python, JS, Java, Go | Python, JS, Java, C# | Python, JS, Java, Go | Python | Python, JS | Python |
Which broker API is best for analysis on White Stallion?
🏆 For maximum value at zero cost: ICICI Breeze
ICICI Direct's Breeze API allows up to 100 calls per minute and 5,000 calls per day, with no charges for accessing the API or the data. You get free access to 3 years of F&O historical data, real-time OHLC and Options Chain data, order status over WebSockets, and can automate strategies or monitor portfolios in real-time — at zero cost. No hidden tiers, no "free except for data" limits.
For serious Zerodha users
The ₹500/month Kite Connect paid plan is worth it. The free Kite Connect Personal tier is useful for placing orders and tracking positions, but the free plan does not include live market data or historical data — those require the paid ₹500/month plan. That's ₹6,000/year for exchange-grade data across the entire F&O universe.
If you value the broadest feature set at zero cost: Upstox V3 and Angel One SmartAPI are solid picks. Both give live data + historical + option chain free. Fyers API is also free and developer-friendly, with live feeds, order placement, historical charts, and an active Python community. If you're starting fresh and want the cleanest UI: Dhan — built-in TradingView charting, advanced option chain with live Greeks, Max Pain, IV, OI trends.
For most White Stallion users, I recommend starting with whichever broker you already have an account with. You're already paying the brokerage; unlock the API for zero incremental cost.
4. What exactly can you do with your broker API on White Stallion?
Once your broker API is connected to White Stallion AI, a completely different class of analysis becomes possible. Here is a concrete inventory of what you unlock:
4.1 Live portfolio dashboard with actual P&L
The moment you link your broker API, White Stallion pulls in every position you hold — equity, F&O, mutual funds — with the exact average price, quantity, and current mark-to-market. Your portfolio shows real-time unrealized P&L that updates every 15 seconds during market hours. No more manually typing holdings into a tracker.
The key unlock: because we have your actual positions, the Strategy Lab can pre-populate strategy legs from positions you already own. Planning to sell a covered call on your 500 TITAN shares? White Stallion knows you have them and sets up the analysis with TITAN lot size (101), current spot, and your exact inventory.
4.2 Real-time Strategy Lab analysis on your actual holdings
This is the flagship workflow. You pick any of your held stocks (or any F&O instrument) and build an options strategy visually. Because the broker API feeds live spot + live option chain, the payoff chart, Greeks panel, and margin estimate update in real time. You see exactly:
- Maximum profit, maximum loss, breakeven points with current IV baked in
- Greeks exposure — delta, theta, vega, gamma — for the whole strategy net
- Required margin computed via SEBI/NSE rules (SPAN + Exposure)
- Days to expiry with automatic theta decay projections
- Probability of profit based on current implied volatility
Without a broker API, you'd be entering spot prices manually (and they'd be stale by the time you finished typing). With it, the Lab is always live.
4.3 Backtest strategies on 3-10 years of your broker's own historical data
This is where broker APIs truly shine. Breeze API has historical data for Futures and Options trading — at present 3 years of data, completely free. White Stallion's backtesting engine can pull this data directly, replay any strategy you define, and show you:
- How would this covered-call strategy have performed over the last 3 years?
- What was the worst drawdown on this iron condor approach in 2023?
- Which months historically favored put credit spreads on BANKNIFTY?
- What's the Sharpe ratio of this approach versus buy-and-hold?
Because the data comes from your broker's feed, the backtest matches the execution conditions you'd experience in live trading. No survivorship bias, no optimistic slippage assumptions.
4.4 Live option chain with Greeks and OI heatmap
Each broker's API exposes a single-call option chain fetch — one request pulls the entire strike-by-strike expiry data including calls, puts, volumes, OI, IV. White Stallion visualizes this as an interactive heatmap where hot zones (high OI changes, unusual volume) stand out immediately. For F&O traders, this alone is worth the setup.
4.5 Paper-trade simulation that mirrors real execution
With the broker API providing live quotes, you can run the Strategy Lab in paper-trade mode: every strategy you "execute" gets logged as if it were real, tracked over its lifetime with actual fills at actual spot prices. No real money at risk, but conditions as close to live execution as any platform can offer.
4.6 Automated technical indicator analysis across your watchlist
Feed your broker-API-connected watchlist through White Stallion's technicals engine and get RSI, MACD, Bollinger Bands, moving averages, volume trends, support/resistance levels computed on the fly — daily, weekly, intraday. Replaces 3-4 separate tools most traders currently cobble together.
4.7 SEBI-compliant position-size guidance
Because we know your portfolio size and F&O positions via the API, White Stallion can flag positions that exceed safe risk thresholds (more than 5% of capital in one leg, more than 20% in one underlying, more than 2x leverage). Impossible with screen-scraped data — needs true portfolio context.
5. Step-by-step setup — from zero to live analysis in 10 minutes
The setup is genuinely faster than most traders expect. Here are broker-specific walkthroughs.
5.1 Zerodha Kite Connect setup
Prerequisite: Active Zerodha trading account. If you don't have one, open it at zerodha.com — free, ~15 minutes.
Visit the developer signup page
Go to developers.kite.trade/signup and register with the email linked to your Zerodha account.
Create a new app
Navigate to "My Apps" → "Create New App". Choose between:
- Kite Connect Personal (Free): Orders + positions + holdings + funds. No live market data or historical data.
- Kite Connect Paid (₹500/month): Personal features + live market data + historical data.
For White Stallion analysis, you need the Paid plan — live data is essential for Strategy Lab, Greeks, and backtesting.
Fill in app details
App type: "Connect"
Redirect URL: https://whitestallion.in/api/broker/zerodha/callback
Postback URL: https://whitestallion.in/api/broker/zerodha/postback (optional)
Description: "White Stallion portfolio analysis"
Copy API Key + Secret
After creation, you'll get an API Key and API Secret. Copy both.
Connect in White Stallion
In White Stallion, go to Settings → Broker Connections → Add Zerodha, paste your API Key and Secret. Click "Connect Now" and you'll be redirected to Zerodha's login page. Log in, confirm the authorization, and you're back in White Stallion with your account linked.
⚠ SEBI Static IP Note
From August 2025, Zerodha requires a static IP for order-placement APIs. For analysis-only (read-only) use — which is the primary White Stallion use case — this is NOT required. You can safely use White Stallion on any home network, mobile hotspot, or laptop.
5.2 ICICI Breeze setup Recommended for most users
Prerequisite: Active ICICI Direct trading account.
Log in to developer portal
Visit api.icicidirect.com/apiuser/home and log in with your ICICI Direct credentials.
Register an app
Click "Register an App" and provide:
App Name: White Stallion Analysis
Redirect URL: https://whitestallion.in/api/broker/icici/callback
IP Address: For analysis-only use, leave blank or use current IP. Order placement requires static IP from April 1, 2026 per new SEBI rules — but for read-only analysis this doesn't apply.
Copy App Key + Secret Key
"View Apps" section shows your App Key (api_key) and Secret Key (api_secret).
Generate session token (daily)
ICICI uses a daily-token pattern — you re-authenticate once per trading day. White Stallion automates this with a 1-click login popup.
Connect in White Stallion
Settings → Broker Connections → Add ICICI Direct. Paste App Key + Secret Key. Click Connect. Confirm the daily-token popup and you're in.
What you get at zero cost:
Breeze API allows up to 100 calls per minute and 5,000 calls per day, enabling you to fetch real-time data, automate trades, and monitor your portfolio with no additional charges. These limits apply across all endpoints — stock quotes, option chain data, order placement.
5.3 Upstox API setup
Prerequisite: Active Upstox trading account.
- Log in to upstox.com/developer and click "Create New App".
- Fill in: App Name (White Stallion Analysis), Redirect URL (
https://whitestallion.in/api/broker/upstox/callback), Postback URL optional. - Copy Client ID (API Key) and Client Secret.
- In White Stallion → Settings → Broker Connections → Add Upstox. Paste credentials. Authorize via Upstox login. Done.
Upstox-specific notes: Upstox rate limits are the most generous among major brokers (25 API calls/second for quotes). Historical candles via V3 API support everything down to 1-minute granularity. The authenticated V3 API is fully legal and SEBI-compliant.
5.4 Angel One SmartAPI setup
Prerequisite: Angel One trading account.
- Visit smartapi.angelbroking.com and sign in.
- "My Apps" → "Create App". Fill in name, redirect URL (
https://whitestallion.in/api/broker/angel/callback), select permissions. - Copy your API Key and Client Code (format: T-XXXXX).
- In White Stallion → Settings → Broker Connections → Add Angel One. Paste credentials, authorize, done.
Angel One SmartAPI is fully free — APIs are free of cost and you only pay brokerage for actual trades at standard rates.
6. Live testing workflows — 5 concrete trading scenarios
Let me walk through exactly how an Indian trader uses broker-API-powered White Stallion in real situations.
Workflow 1: Weekly covered call on your existing stock holdings
Scenario: You own 1,003 shares of Reliance (RELIANCE). You want to generate monthly income by writing covered calls, but you need to know exactly how much premium you'd collect and what your breakeven looks like.
Before broker API: Open NSE's option chain page, manually note strike prices, open a spreadsheet, calculate premium × lot size × number of lots, estimate breakeven manually, hope you didn't miscalculate. 15-30 minutes per strike.
With White Stallion + broker API:
- Open Strategy Lab, click "Covered Call" template
- White Stallion auto-detects from your broker API that you own 1,003 RELIANCE shares (so you can write 2 calls of lot size 500 each)
- Live option chain loads automatically — every available strike for the next 4 expiries with live bid/ask/IV
- You pick a strike (say, 1,450 CE, 1 week out, current spot 1,365)
- Payoff chart renders instantly: maximum profit ₹X, maximum loss if assigned, breakeven at 1,450 + premium collected
- Greeks panel shows theta decay per day, delta exposure
- Decide. Execute via broker app (or paper-trade it first)
Time: 90 seconds. Accuracy: exact.
Workflow 2: Building an iron condor on BANKNIFTY with live option chain
Scenario: You expect BANKNIFTY to range between 54,000 and 55,500 over the next 8 days. You want an iron condor to profit from range-bound movement.
With White Stallion + broker API:
- Strategy Lab → "Iron Condor" template
- Symbol selector: BANKNIFTY (spot updates live from broker feed)
- Visual strike-picker: drag 4 strikes onto expected range (54000 PE buy, 54500 PE sell, 55500 CE sell, 56000 CE buy)
- Live premiums populate instantly from broker API
- Payoff chart shows: maximum profit ₹X (credit received), maximum loss at tails, two breakevens, profit zone visually highlighted
- Margin panel shows realistic SPAN + Exposure — matching Zerodha/ICICI's actual requirement
- Stress-test by dragging the spot slider — what if BANKNIFTY goes to 53,500? 56,500? Visual answer in real time
Why broker API matters here: Iron condors are highly sensitive to entry premiums. A 2% difference in premium can flip the trade from profitable to loss-making. Stale data kills this analysis.
Workflow 3: Backtesting a monthly put-writing strategy over 3 years
Scenario: Test "sell 1 BANKNIFTY 10-delta monthly put on expiry day of previous month, hold to expiry, repeat" — does this make money over 3 years?
With White Stallion + broker API:
- Backtest module → select strategy "Systematic put writing"
- Define rules: underlying, delta target, holding period, entry/exit triggers
- White Stallion pulls 3 years of BANKNIFTY historical option data from your broker API (ICICI Breeze: 3 years free)
- Engine replays every trade: entry premium, daily mark-to-market, early exits, expiry settlement
- Results: total P&L, Sharpe ratio, maximum drawdown, win rate, worst trade, best trade, monthly breakdown
- See if the strategy works before risking ₹1 of real capital
Hidden value: Because historical data comes from your broker's feed, it includes actual option pricing — not just theoretical Black-Scholes. Captures the real skew premium and liquidity discount retail traders face.
Workflow 4: Real-time technicals across your entire portfolio
Scenario: You hold 36 positions. You want a daily morning briefing: which holdings are overbought (RSI > 70), which approach support/resistance, where is smart money positioning?
With White Stallion + broker API: Broker API pulls your 36 positions at 9:00 AM → technicals engine computes RSI (14), MACD, Bollinger Bands, 50/200 DMA, volume trends for every holding → morning briefing flags overbought/near-support/under-distribution → click any flagged stock for detailed chart. Replaces 3-4 separate paid tools.
Workflow 5: F&O position monitoring with automatic Greeks aggregation
Scenario: 8 open F&O positions — 2 futures, 4 options long, 2 options short. You want your net portfolio delta, theta, vega at any moment during trading hours.
With White Stallion + broker API: Broker API feeds open positions continuously → F&O Operations tab aggregates Greeks across all positions → net delta (directional exposure), net theta (daily time decay), net vega (IV exposure), net gamma (convexity) → updates every 15 seconds during market hours → alerts when any Greek crosses your defined threshold. Critical for serious F&O traders — one sharp move without knowing net delta can cost lakhs.
7. Advanced: combining broker APIs with White Stallion's strategy engine
White Stallion AI has a single "Symbol Spine" architecture (Sprint 14.5) that routes every piece of data — broker-API holdings, live spot, option chain, Greeks, margin calculations — through one canonical channel. When you change the active symbol anywhere in the app, everything updates in sync.
The broker API as a data source tier
Under the hood, White Stallion treats data sources as a resilient chain:
- Primary (logged-in users): Your broker API — real-time, licensed, exchange-grade
- Secondary: Yahoo Finance v10 — fallback when broker API is down
- Tertiary: Twelve Data / Finnhub paid commercial — fallback when both above fail
- Fallback: IndexedDB cache — last-known values when offline
The moment you connect a broker API, you jump to tier 1 automatically. No manual switching.
Multi-broker support
You can connect multiple broker APIs to one White Stallion account. Positions split across ICICI (long-term equity) and Zerodha (F&O)? Connect both. White Stallion merges them into a unified portfolio view.
Privacy and data ownership
🔒 Direct commitment
- Your broker API credentials are stored encrypted locally in your browser. They never leave your device.
- White Stallion's servers do not store your API credentials.
- Your positions and trades are pulled directly from your broker to your browser — they do not transit through our servers.
- When you disconnect the broker, the credentials are wiped.
8. Safety, security & SEBI's April 2026 rules
The SEBI static-IP requirement
As of April 1, 2026, SEBI requires a static IP to be mandatory for API-based trading. This applies specifically to order-placement APIs — APIs that actually submit buy/sell orders to the exchange.
This does NOT apply to read-only analysis use. If you're using broker APIs through White Stallion for portfolio monitoring, strategy simulation, backtesting, or non-order-placing analysis, static IP is not required. You can use any network.
If you eventually want to place orders via API (algo trading), options include:
- Static IP service from your ISP (₹2,000-5,000/year)
- Cloud VPS with static IP (DigitalOcean, AWS Lightsail, ~₹500/month)
- Specialized static IP services
Read-only vs read-write API scopes
Every broker API lets you choose scope:
- Read-only: Fetch positions, holdings, quotes, historical data. Cannot place/modify/cancel orders.
- Read-write: Everything above plus order execution.
White Stallion defaults to read-only. You explicitly enable order placement in Settings, and even then, every order requires a confirmation click. No silent auto-trading.
Credentials security — practical checklist
- Never share your API Key + Secret with anyone.
- Rotate your API keys every 90 days.
- Use different keys for different apps — don't reuse across White Stallion, Python scripts, third-party tools.
- Check "View Apps" monthly for unauthorized apps.
- Enable TOTP/2FA on your underlying broker login.
- Log out or clear broker data when using shared computers.
9. FAQ — the questions traders actually ask
For most brokers (ICICI, Upstox, Angel One, Dhan, Fyers), the API access is genuinely free. The "catch" is that you need an active trading account with that broker — so the broker hopes you trade actively and generate brokerage revenue. No API subscription fee. Zerodha charges ₹500/month specifically for live + historical data (execution APIs are free).
Only if you explicitly enable order placement (not on by default) AND only when you click confirm for each order. No silent auto-trading. You stay in full control.
Yes. Your broker API is between you and your broker — White Stallion is just one consumer. Disconnecting from White Stallion doesn't affect your broker API availability for other apps.
No. White Stallion's entire broker-API workflow is built for non-coders. You click "Connect Zerodha", authorize on Zerodha's page, and you're done. Everything after is visual.
White Stallion has a resilient data chain (broker → Yahoo → commercial vendor → cache). If your primary broker API is unavailable, we automatically fail over. You'll see "Broker down, using backup" — but the app keeps working.
Yes. Many traders spread positions across 2-3 brokers. Connect all of them and White Stallion merges everything into one unified view.
Yes. Broker APIs respect corporate actions and adjust historical data accordingly. Much better than Yahoo-style public data, which sometimes gets corporate-action adjustments wrong.
For typical analysis use, you'll use 100-500 API calls per day. All major broker APIs allow 5,000+ calls/day. White Stallion throttles backtest requests automatically to stay within bounds.
We plan to support Zerodha Kite, ICICI Breeze, Upstox, Angel SmartAPI, Dhan, Fyers, and Kotak Neo by end of 2026. Specific additions depend on user demand — email whitestallionai@gmail.com.
The broker API unlocks the full data layer. White Stallion's own subscription tiers are for analysis tools on top (AI advisor credits, advanced backtesting, unlimited strategies). A free tier covers everyday usage.
10. Get started today
The Indian retail trader who connects a broker API to a serious analysis platform has an enormous informational edge over the retail trader who only uses the broker's own app. You can see your Greeks. You can backtest strategies on your own data. You can build and simulate trades before committing capital. You can spot opportunities your broker app would never highlight.
And it costs you zero rupees more than you're already paying.
Your next 10 minutes:
- Open whitestallion.in in your browser
- Sign in with Google (20 seconds)
- Settings → Broker Connections → Add Broker
- Pick ICICI Direct, Zerodha, Upstox, Angel One, or Dhan
- Follow the broker-specific setup wizard above
- Watch your portfolio appear with live data
- Open Strategy Lab, pick any holding, build your first covered call analysis