Archives¶
Download NSE reports and archives via the /api/reports endpoint.
All methods return raw bytes by default. Pass as_df=True to auto-download
and parse as a polars DataFrame.
Convenience Methods¶
client.archives.equity_bhavcopy(date, as_df=False)¶
Download equity bhavcopy (PR.zip).
raw = client.archives.equity_bhavcopy("06-May-2026")
df = client.archives.equity_bhavcopy("06-May-2026", as_df=True)
client.archives.equity_full_bhavcopy(date, as_df=False)¶
Full bhavcopy with delivery data.
df = client.archives.equity_full_bhavcopy("06-May-2026", as_df=True)
client.archives.fo_bhavcopy(date, as_df=False)¶
F&O bhavcopy (fo.zip).
df = client.archives.fo_bhavcopy("06-May-2026", as_df=True)
client.archives.commodity_bhavcopy(date, as_df=False)¶
Commodity bhavcopy.
df = client.archives.commodity_bhavcopy("06-May-2026", as_df=True)
client.archives.indices_snapshot(date, as_df=False)¶
Daily indices snapshot.
df = client.archives.indices_snapshot("06-May-2026", as_df=True)
client.archives.fo_open_interest(date, as_df=False)¶
F&O NCL open interest.
df = client.archives.fo_open_interest("06-May-2026", as_df=True)
client.archives.equity_volatility(date, as_df=False)¶
Daily equity volatility.
df = client.archives.equity_volatility("06-May-2026", as_df=True)
Generic Download¶
client.archives.download(report_key, date, as_df=False)¶
Download any report by key.
data = client.archives.download("fo_settlement_prices", "06-May-2026")
df = client.archives.download("commodity_volatility", "06-May-2026", as_df=True)
Archives.available_reports()¶
List all available report keys.
keys = client.archives.available_reports()
# → ['commodity_base_price', 'commodity_bhavcopy', ..., 'indices_snapshot', ...]
All Report Keys¶
Equities (capital-market):
equities_bhavcopy— CM - Bhavcopy (PR.zip)equities_full_bhavcopy— Full Bhavcopy and Security Deliverable dataequities_volatility— CM - Daily Volatilityequities_var_margin— CM - VaR Margin Rates (End of day)equities_turnover— CM - Category-wise Turnoverequities_market_pulse— NSE Market Pulse (.pdf)
Indices (capital-market):
indices_snapshot— Daily Snapshotindices_mcap_weight_beta— Market Capitalisation, Weightage, Beta for NIFTY 50 & NIFTY Next 50indices_impact_cost— Impact Costindices_mcap_weight— Indices - Market Capitalisation & Weightageindices_fixed_income— Index Dashboard - Fixed Incomeindices_nifty50_top10— NIFTY 50 Top 10 Holdings (csv)
F&O (derivatives — equity):
fo_bhavcopy— F&O - Bhavcopy (fo.zip)fo_market_activity— F&O - Market Activity Reportfo_volatility— F&O - Daily Volatilityfo_settlement_prices— F&O - Daily Settlement Pricesfo_combined— F&O - Combined Reportfo_open_interest— F&O - NCL Open Interestfo_ban_period— F&O - Security in ban periodfo_position_limits— F&O - Clientwise Position Limitsfo_span_risk— F&O - Span Risk Parameter File (2nd intra-day)
Commodity (derivatives):
commodity_bhavcopy— COM - Bhavcopy (zip)commodity_stock_position— COM - Daily Stock Position Reportcommodity_volatility— COM - Volatilitycommodity_base_price— COM - Base Pricecommodity_market_activity— COM - Market Activity Report
Currency (derivatives):
currency_settlement— CD - Settlement Pricescurrency_volatility— CD - Volatilitycurrency_base_price— CD - Base Pricecurrency_market_activity— CD - Market Activity Reportcurrency_mode_of_trading— CD - Mode of Tradingcurrency_bhavcopy— CD-Bhavcopy File (DAT)currency_contract_files— CD-MII - Contract Files (.gz)
Date Format¶
All archive methods use DD-Mon-YYYY format: "06-May-2026", "15-Jan-2026".