Upstox

Upstox Market Holidays and Timings API

The Market Holidays and Timings API from Upstox — 13 operation(s) for market holidays and timings.

GitHub OpenAPI

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/market/timings/{date} Get exchange trading hours on a date · Get Exchange Timings on particular date #
Ask an LLM
“What time do NSE and MCX open and close on a particular day?”
“Are there special trading hours on a given date, like a Muhurat session?”
Tell an agent
Get the exchange timings for {date}.
Show the open and close times of each exchange on {date}.
GET /v2/market/status/{exchange} Check whether an exchange is open · Get Market status for particular exchange #
Ask an LLM
“Is the NSE market open right now?”
“What is the current status of a specific exchange?”
Tell an agent
Check the market status of {exchange}.
Tell me if {exchange} is open for trading now.
GET /v2/market/smartlist/options List top options by activity or movement · Get Smartlist Options #
Ask an LLM
“Which options are most actively traded today?”
“What index options have the biggest open interest gains?”
Tell an agent
Show the {category} options smartlist.
List {category} options for {asset_type} underlyings.
GET /v2/market/smartlist/mtf List stocks eligible for margin trade funding · Get Smartlist MTF #
Ask an LLM
“Which stocks can I buy with margin trade funding?”
“What is the MTF smartlist with live prices?”
Tell an agent
Show the MTF stock smartlist.
List page {page_number} of margin-funded stocks, {page_size} per page.
GET /v2/market/smartlist/futures List top futures by activity or movement · Get Smartlist Futures #
Ask an LLM
“Which futures contracts are most traded today?”
“What commodity futures are the top OI losers right now?”
Tell an agent
Show the {category} futures smartlist.
List {category} futures on {asset_type}.
GET /v2/market/pcr Get put-call ratio for an underlying and expiry · Get PCR Data #
Ask an LLM
“What is the put-call ratio for Nifty options this expiry?”
“How has PCR moved through the day in fixed-minute buckets?”
Tell an agent
Get PCR for {instrument_key} expiring {expiry} on {date} in {bucket_interval}-minute buckets.
Show the put-call ratio trend of {instrument_key} for the {expiry} expiry on {date}, bucketed every {bucket_interval} minutes.
GET /v2/market/oi Get open interest for an underlying and expiry · Get OI Data #
Ask an LLM
“What is the open interest across strikes for an index option expiry?”
“Where is open interest building up for a given expiry on a certain day?”
Tell an agent
Get open interest for {instrument_key} expiry {expiry} on {date}.
Show OI by strike for {instrument_key}, {expiry} contracts, as of {date}.
GET /v2/market/max-pain Get max pain level for an options expiry · Get Max Pain Data #
Ask an LLM
“What is the max pain strike for this week's Bank Nifty expiry?”
“How has the max pain level shifted during the trading day?”
Tell an agent
Get max pain for {instrument_key} expiry {expiry} on {date} with {bucket_interval}-minute buckets.
Track the max pain strike of {instrument_key} for {expiry} on {date} every {bucket_interval} minutes.
GET /v2/market/holidays List this year's market holidays · Get Holiday list of current year #
Ask an LLM
“Which days are stock market holidays this year?”
“When is the exchange closed for trading during the current year?”
Tell an agent
List all market holidays for the current year.
Show me this year's exchange holiday calendar.
GET /v2/market/holidays/{date} Check if a date is a market holiday · Get Holiday on particular date #
Ask an LLM
“Is the market closed on a specific date?”
“Which exchanges are shut for a holiday on a given day?”
Tell an agent
Check whether {date} is a market holiday.
Tell me which exchanges are closed on {date}.
GET /v2/market/fii Get FII trading activity · Get FII Data #
Ask an LLM
“How much are foreign institutional investors buying or selling in index futures?”
“What has FII activity in index options looked like month by month?”
Tell an agent
Get FII activity for {data_type} at {interval} interval.
Show foreign institutional flows in {data_type} by {interval} starting {from}.
GET /v2/market/dii Get DII cash market activity · Get DII Data #
Ask an LLM
“Are domestic institutions net buyers in the cash market today?”
“What is the monthly trend of DII buying and selling?”
Tell an agent
Get DII activity for {data_type} at {interval} interval.
Show domestic institutional flows in {data_type} per {interval} from {from}.
GET /v2/market/change-oi Get change in open interest over days · Get Change in OI Data #
Ask an LLM
“How much has open interest changed at each strike over the last few days?”
“Where is fresh OI being added or unwound for an expiry?”
Tell an agent
Get the change in OI for {instrument_key} expiry {expiry} on {date} over {interval} days.
Show OI added or unwound in {instrument_key} {expiry} contracts across {interval} days up to {date}.

Documentation

📖
Documentation
https://upstox.com/developer/api-documentation/open-api
📖
APIReference
https://upstox.com/developer/api-documentation/api-overview
📖
GettingStarted
https://upstox.com/developer/api-documentation/installing-sdk
📖
Authentication
https://upstox.com/developer/api-documentation/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/upstox/refs/heads/main/openapi/upstox-market-holidays-and-timings-api-openapi.yml

Other Resources

🔗
Postman
https://gist.github.com/Rahulzz/a0da2ad28a7dcc81e887f24cfdbc80a8
🔗
Webhooks
https://upstox.com/developer/api-documentation/webhook

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/upstox:upstox-market-holidays-and-timings-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

upstox-market-holidays-and-timings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAPI definition Market Holidays and Timings API
  version: v0
servers:
- url: https://api-v2.upstox.com
tags:


# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/upstox/refs/heads/main/openapi/upstox-market-holidays-and-timings-api-openapi.yml