55 working examples showcasing Upstox API features — Instrument Search, Analytics Token, Market Data, and Fundamentals — across futures spreads, options strategies, arbitrage, historical analysis, live market data, fundamentals analysis, and more.
cd interactive_examples
pip install -r requirements.txt
python instrument_search/search_equity.py --token <TOKEN> --query RELIANCEA Streamlit web app wraps every example with a UI — paste your token and run:
Or run locally:
git clone https://github.com/upstox/python-examples
cd python-examples
pip install -r requirements.txt
streamlit run streamlit_app.py| Token | How to get | Valid for | Can trade? |
|---|---|---|---|
| Analytics token | Developer Apps → Analytics tab | 1 year | No (read-only) |
| Access token | Standard OAuth flow | 1 day | Yes |
Use the analytics token for all examples below — no daily login needed.
Run all examples automatically against a real token:
python test_runner.py --token <TOKEN>- Validates the token before starting
- Runs every script non-interactively and reports PASS / FAIL
- Streaming scripts (WebSocket depth) are auto-aborted after 5 seconds and counted as PASS
Demonstrates the GET /v2/instruments/search endpoint — find instruments dynamically by name, exchange, segment, option type, expiry, and ATM offset.
| Script | What it does |
|---|---|
instrument_search/search_equity.py |
Search equity stocks — instrument key, ISIN, lot size |
instrument_search/search_futures.py |
List all futures for a symbol sorted by expiry |
instrument_search/search_options.py |
Search options with expiry + ATM offset filters |
python instrument_search/search_equity.py --token <TOKEN> --query RELIANCE
python instrument_search/search_futures.py --token <TOKEN> --query BANKNIFTY
python instrument_search/search_options.py --token <TOKEN> --query NIFTY --expiry current_month| Script | What it does |
|---|---|
futures_basis/nifty_futures_spread.py |
Near vs far NIFTY futures — calendar spread + contango/backwardation signal |
futures_basis/banknifty_futures_spread.py |
Same for BankNifty (weekly expiries) |
futures_basis/cash_futures_basis.py |
Index spot vs futures — basis and implied annualised carry |
futures_basis/futures_roll_cost.py |
Cost to roll long/short from near to far month |
futures_basis/mcx_crude_spread.py |
MCX crude oil near/far spread |
python futures_basis/nifty_futures_spread.py --token <TOKEN>
python futures_basis/cash_futures_basis.py --token <TOKEN> --query "NIFTY 50"
python futures_basis/futures_roll_cost.py --token <TOKEN> --side long| Script | What it does |
|---|---|
options_strategies/straddle_pricer.py |
ATM straddle — total premium, breakevens |
options_strategies/strangle_pricer.py |
OTM strangle — cost, breakevens |
options_strategies/bull_call_spread.py |
Bull call spread — net debit, max profit, breakeven |
options_strategies/iron_condor_setup.py |
Iron condor — 4 legs, net credit, profit zone |
options_strategies/butterfly_spread.py |
Butterfly spread — max profit at ATM at expiry |
options_strategies/calendar_spread_options.py |
Calendar spread — sell near, buy far, same strike |
options_strategies/put_call_parity.py |
Put-call parity check — C − P vs F − K deviation |
python options_strategies/straddle_pricer.py --token <TOKEN> --query NIFTY
python options_strategies/iron_condor_setup.py --token <TOKEN> --short_offset 2
python options_strategies/put_call_parity.py --token <TOKEN> --query BANKNIFTY| Script | What it does |
|---|---|
options_analytics/options_chain_builder.py |
Live options chain across ±N strikes from ATM |
options_analytics/max_pain_calculator.py |
Max pain strike from OI — where option buyers lose most |
options_analytics/oi_skew.py |
CE vs PE OI by strike — support/resistance + PCR |
options_analytics/volatility_skew.py |
OTM PE/CE premium ratio — negative skew visualisation |
options_analytics/gamma_exposure.py |
Dealer gamma exposure (GEX) by strike |
options_analytics/option_chain_native.py |
Full option chain via dedicated OptionsApi — CE/PE OI, LTP, IV by strike |
options_analytics/option_greeks.py |
Delta, gamma, theta, vega, IV for ATM ± N strikes |
options_analytics/pcr_trend.py |
Put-Call Ratio from OI — per-strike breakdown + bullish/bearish signal |
options_analytics/iv_percentile.py |
IV Percentile & IV Rank — where current IV stands vs 1-year history |
options_analytics/implied_move.py |
Expected move from ATM straddle — upper/lower range as % |
options_analytics/expiry_decay.py |
Expiry-day premium decay — ATM ± N premiums as % of prior close |
python options_analytics/options_chain_builder.py --token <TOKEN> --query NIFTY --strikes 5
python options_analytics/option_chain_native.py --token <TOKEN> --query NIFTY
python options_analytics/pcr_trend.py --token <TOKEN> --query NIFTY
python options_analytics/iv_percentile.py --token <TOKEN> --query NIFTY
python options_analytics/implied_move.py --token <TOKEN> --query NIFTY
python options_analytics/expiry_decay.py --token <TOKEN> --query NIFTY --strikes 3| Script | What it does |
|---|---|
arbitrage/nse_bse_arbitrage.py |
Same stock on NSE vs BSE — price spread + arbitrage direction |
arbitrage/etf_vs_index.py |
ETF LTP vs index NAV — premium/discount |
arbitrage/currency_futures_spread.py |
USDINR near/far spread — interest rate parity |
python arbitrage/nse_bse_arbitrage.py --token <TOKEN> --query RELIANCE
python arbitrage/etf_vs_index.py --token <TOKEN>
python arbitrage/currency_futures_spread.py --token <TOKEN> --pair USDINRThese work best with the analytics token — fetch up to years of data without re-authenticating.
| Script | What it does |
|---|---|
historical_analysis/historical_candle.py |
OHLC candles for any instrument and interval |
historical_analysis/moving_average.py |
SMA(20)/SMA(50) crossover signal |
historical_analysis/historical_volatility.py |
Annualised realised volatility from daily closes |
historical_analysis/week_52_high_low.py |
52-week high/low and position-in-range |
historical_analysis/vwap.py |
VWAP from intraday 1-min candles — current price vs VWAP signal |
historical_analysis/beta_calculator.py |
Stock beta vs NIFTY 50 index + correlation coefficient |
historical_analysis/stock_correlation.py |
Pairwise Pearson correlation of daily returns for 2+ stocks |
python historical_analysis/historical_candle.py --token <ANALYTICS_TOKEN> --query RELIANCE
python historical_analysis/moving_average.py --token <ANALYTICS_TOKEN> --fast 20 --slow 50
python historical_analysis/vwap.py --token <TOKEN> --query RELIANCE
python historical_analysis/beta_calculator.py --token <TOKEN> --query RELIANCE --days 60
python historical_analysis/stock_correlation.py --token <TOKEN> --queries RELIANCE,TCS,INFY| Script | What it does |
|---|---|
portfolio_screening/sector_index_comparison.py |
NSE sector indices ranked by daily % change |
portfolio_screening/top_volume_stocks.py |
Search results ranked by traded volume |
portfolio_screening/futures_oi_buildup.py |
Futures OI scanner — long/short buildup signals |
python portfolio_screening/sector_index_comparison.py --token <TOKEN>
python portfolio_screening/top_volume_stocks.py --token <TOKEN>
python portfolio_screening/futures_oi_buildup.py --token <TOKEN>| Script | What it does |
|---|---|
market_data/market_status.py |
Live open/closed/pre-open status for NSE, BSE, MCX, NFO, BFO, CDS |
market_data/market_holidays.py |
Full-year holiday calendar — upcoming vs past, with MCX partial session labels |
market_data/market_timings.py |
Exchange session windows for any date with ACTIVE highlight |
market_data/intraday_chart.py |
Terminal candlestick + volume chart (plotext) for any index |
market_data/live_depth.py |
Live 5-level depth: NIFTY FUT + SENSEX FUT + RELIANCE NSE/BSE in a 2×2 grid |
market_data/live_depth_d30.py |
30-level depth via WebSocket (requires Upstox Plus Pack) |
market_data/live_depth_mcx.py |
Live depth for top MCX commodities (GOLD, SILVER, CRUDEOIL, NATURALGAS) |
market_data/live_depth_usdinr.py |
USDINR near-month futures — NSE CDS vs BSE BCD side by side |
python market_data/market_status.py --token <TOKEN>
python market_data/market_holidays.py --token <TOKEN>
python market_data/intraday_chart.py --token <TOKEN> --query SENSEX --interval 5
python market_data/live_depth.py --token <TOKEN> # Ctrl-C to stop
python market_data/live_depth_mcx.py --token <TOKEN> # Ctrl-C to stopUses the Upstox Fundamentals API. Pass --symbol with a stock name — the ISIN is resolved automatically.
| Script | What it does |
|---|---|
fundamentals/company_profile.py |
Sector, industry, market cap, employees and business overview |
fundamentals/key_ratios.py |
P/E, P/B, ROE, ROCE, D/E and more vs sector average |
fundamentals/balance_sheet.py |
Historical total assets, liabilities and derived equity |
fundamentals/income_statement.py |
Revenue, operating profit, net profit and EPS over time |
fundamentals/cash_flow.py |
Operating, investing and financing cash flows across periods |
fundamentals/corporate_actions.py |
Dividends, stock splits, bonuses — sorted most-recent first |
fundamentals/share_holdings.py |
Quarterly promoter / FII / DII / public shareholding |
fundamentals/competitors.py |
Peer companies in the same sector with market cap comparison |
python fundamentals/company_profile.py --token <TOKEN> --symbol RELIANCE
python fundamentals/key_ratios.py --token <TOKEN> --symbol TCS
python fundamentals/balance_sheet.py --token <TOKEN> --symbol HDFCBANK
python fundamentals/income_statement.py --token <TOKEN> --symbol INFY
python fundamentals/cash_flow.py --token <TOKEN> --symbol WIPRO
python fundamentals/corporate_actions.py --token <TOKEN> --symbol HDFCBANK
python fundamentals/share_holdings.py --token <TOKEN> --symbol RELIANCE
python fundamentals/competitors.py --token <TOKEN> --symbol TCSUses the Upstox Market Information API. Note: Market Holidays, Market Timings, and Exchange Status live under market_data/ above.
| Script | What it does |
|---|---|
market_information/fii_data.py |
FII buy / sell / OI activity by segment (cash, futures, options) and interval |
market_information/dii_data.py |
DII buy / sell flow for the NSE cash market |
market_information/oi_data.py |
Per-strike call / put open interest for an underlying + expiry |
market_information/change_oi.py |
Per-strike change in OI over a configurable lookback |
market_information/max_pain.py |
Max pain strike + intraday max-pain vs spot |
market_information/pcr_data.py |
Overall PCR + intraday PCR / spot data points |
python market_information/fii_data.py --token <TOKEN> --data-type "NSE_EQ|CASH" --interval 1D
python market_information/dii_data.py --token <TOKEN> --interval 1M
python market_information/oi_data.py --token <TOKEN> --expiry 2026-05-29
python market_information/change_oi.py --token <TOKEN> --expiry 2026-05-29 --interval 5
python market_information/max_pain.py --token <TOKEN> --expiry 2026-05-29 --bucket-interval 60
python market_information/pcr_data.py --token <TOKEN> --expiry 2026-05-29 --bucket-interval 60The streamlit_app.py wraps all 47 examples in a browser UI with interactive inputs and charts (including Plotly charts for fundamentals).
- Fork / push this repo to GitHub
- Go to share.streamlit.io → New streamlit_app
- Select this repo, branch
main, filestreamlit_app.py - Click Deploy — you get a shareable URL instantly
pip install -r requirements.txt
streamlit run streamlit_app.pyinteractive_examples/
├── utils.py # Shared helpers — SDK client, search, quotes, history
├── test_runner.py # Automated test harness for all examples
├── requirements.txt
├── instrument_search/ # 3 scripts
├── futures_basis/ # 5 scripts
├── options_strategies/ # 7 scripts
├── options_analytics/ # 11 scripts
├── arbitrage/ # 3 scripts
├── historical_analysis/ # 7 scripts
├── portfolio_screening/ # 3 scripts
├── market_data/ # 8 scripts
├── fundamentals/ # 8 scripts
└── market_information/ # 6 scripts
Every script accepts --token on the command line. The analytics token works identically to a daily access token — just pass it with --token. The only differences:
| Access token | Analytics token | |
|---|---|---|
| Validity | 1 day | 1 year |
| OAuth flow | Required daily | Not needed |
| Trading | Yes | No (read-only) |
| Market data | Yes | Yes |
| Historical data | Yes | Yes |
upstox-python-sdk
plotext
Python 3.9+ required.