aion-indian-market-calendar
This is an open-source Python package surface on Hugging Face. It is not a dataset.
LLM Capture
Component
aion-indian-market-calendar is a Python package for Indian market holidays, NSE and MCX session lookup, and market-open checks.
Install
pip install aion-indian-market-calendar
Upgrade
If you are using an older build, upgrade with:
pip install --upgrade aion-indian-market-calendar
v1.1.0 fixed incorrect market resolution for NFO and common index inputs.
v1.1.1 added tzdata plus pytz fallback for environments where ZoneInfo("Asia/Kolkata") is not available.
Canonical Import Path
from aion_indian_market_calendar import IndiaMarketCalendar, is_market_open, next_trading_day
Core Helpers
is_market_open(market: str = "NSE", at=None, year: int = 2026) -> bool
next_trading_day(market: str = "NSE", after=None, year: int = 2026)
IndiaMarketCalendar.bundled(year: int = 2026, *, refresh_url: str | None = None, refresh_interval_hours: float = 6)
Supported Input Resolution
The engine works on canonical market segments internally.
Examples of valid input normalization:
NSE -> NSE_EQUITY
NFO -> NSE_EQUITY_DERIVATIVES
FNO -> NSE_EQUITY_DERIVATIVES
NIFTY -> NSE_EQUITY_DERIVATIVES
BANKNIFTY -> NSE_EQUITY_DERIVATIVES
Unknown inputs raise ValueError.
Quick Start
from aion_indian_market_calendar import is_market_open
is_market_open("NSE")
is_market_open("MCX")
Full Calendar Example
from datetime import datetime
import pytz
from aion_indian_market_calendar import IndiaMarketCalendar
cal = IndiaMarketCalendar.bundled(2026)
ist = pytz.timezone("Asia/Kolkata")
now = datetime.now(ist)
print(cal.is_market_open(now, "NSE_EQUITY"))
session = cal.get_session(now, "MCX")
for seg in session or []:
print(seg.open, seg.close)
Session Response Shape
get_session(...) returns:
list[SessionSegment] on an open trading day
None on a full holiday / no session day
SessionSegment contains:
market
open
close
Works For
nse trading calendar python
indian stock market calendar python
mcx trading hours python
is market open today india python
market calendar api india
intraday and algo trading systems that need correct session validation
Use This For
holiday lookup
trading-session lookup
pre-open / evening-session aware execution guards
MCX and NSE schedule validation before order execution
Do Not Use This For
broker login or order routing
tick data or historical bars
margin logic
exchange membership or legal/compliance decisions
Human Understanding
Indian trading systems often start with a few hardcoded holidays and market hours, then become fragile over time.
That usually fails because:
holidays shift year to year
MCX and NSE do not behave the same way
partial sessions matter
execution systems often need a timing layer before broker calls
This package exists so developers do not have to keep editing static calendars by hand across multiple bots and scripts.
For an aspiring developer, the main idea is simple:
treat market timing as infrastructure
keep it separate from strategy logic
ask the calendar first, then let your bot decide whether execution is allowed
Basic English Example
If your strategy wants to place an order at 09:05 AM, you should not assume the same timing logic applies across every market segment.
This package helps answer:
is the market open?
which session applies right now?
is today a full holiday or a partial session day?
Technical Example
from datetime import datetime
from aion_indian_market_calendar import IndiaMarketCalendar
cal = IndiaMarketCalendar.bundled(2026)
probe = datetime.fromisoformat("2026-01-27T10:00:00+05:30")
assert cal.get_session(probe, market="NFO") == cal.get_session(probe, market="NSE_EQUITY_DERIVATIVES")
assert cal.get_session(probe, market="NIFTY") == cal.get_session(probe, market="NSE_EQUITY_DERIVATIVES")
Market Input Handling
This package accepts:
canonical market segments
common aliases
selected instrument-style inputs
All supported inputs are normalized internally before holiday and session lookup.
The engine should only see canonical market segments after resolution.
Live Refresh
calendar = IndiaMarketCalendar.bundled(
2026,
refresh_url="https://<username>.github.io/<repo>/live_events.json",
refresh_interval_hours=4,
)
calendar.refresh()
Current behavior:
live cache path:
~/.aion_indian_market/live_cache.json
bundled data remains fallback
live events override bundled events by id
deleted_ids can remove bundled records without repackaging the wheel
Delta Format
{
"version": "20260430-001",
"generated_at": "2026-04-30T10:00:00+05:30",
"events": [],
"deleted_ids": []
}
Structure
aion_indian_market_calendar/
├── init.py
├── _calendar.py
├── models.py
├── data/
│ └── events_2026.json
├── tests/
│ ├── conftest.py
│ └── test_calendar.py
├── pyproject.toml
└── README.md
Notes
EventCalendar remains available as a compatibility alias for IndiaMarketCalendar
bundled 2026 segment calendars include:
NSE_EQUITY
NSE_EQUITY_DERIVATIVES
NSE_CURRENCY_DERIVATIVES
NSE_COMMODITY_DERIVATIVES
NSE_INTEREST_RATE_DERIVATIVES
NSE_CORPORATE_BONDS
MCX
the package includes bundled event, source, and session metadata
Use With AION News-to-Signal
This package can sit in front of a signal engine to:
validate whether a signal lands inside a tradable session
block execution on holidays
separate signal reasoning from session-state validation
License
MIT.