# Derivative expiries API

> NSE and BSE futures and options expiry dates, moved for holidays.

Every weekly and monthly expiry of a year from the exchange rules in force since 1 September 2025: NSE on Tuesdays (Nifty 50 weekly), BSE on Thursdays (Sensex weekly), monthly contracts on the month's last one; an expiry on a holiday moves to the trading day before.

Base URL `https://api.dharun.dev`. No API key needed for most endpoints; a free key (https://api.dharun.dev/keys) raises the limits, and the model endpoints marked below will need one. Answers are JSON, `{ "data": ..., "meta": { ... } }`, and errors are `{ "error": { "code", "message" } }` with a matching HTTP status. Rate limit: 600 units a minute per address without a key, 3000 per key; the `RateLimit-*` headers say what is left.

## Expiry dates

`GET /v1/expiries`

Parameters:

- `exchange` (query): Default nse. One of: nse, bse.
- `year` (query): From 2025. Default this year.
- `month` (query): 1 to 12.
- `weekly` (query): false lists only the monthly expiries.

Example: https://api.dharun.dev/v1/expiries?exchange=nse&year=2026&month=3&utm_medium=docs-md

Response, with lists and long text shortened:

```json
{
  "data": [
    {
      "date": "2026-03-02",
      "weekday": "Monday",
      "kind": "weekly",
      "contracts": "Nifty 50 weekly options",
      "moved": "Tue 3 Mar is a holiday (Holi)"
    },
    {
      "date": "2026-03-10",
      "weekday": "Tuesday",
      "kind": "weekly",
      "contracts": "Nifty 50 weekly options"
    },
    {
      "date": "2026-03-17",
      "weekday": "Tuesday",
      "kind": "weekly",
      "contracts": "Nifty 50 weekly options"
    }
  ],
  "meta": {
    "total": 5,
    "source": {
      "name": "Trading and clearing holidays, NSE equities",
      "url": "https://www.nseindia.com/resources/exchange-communication-holidays",
      "licence": "Official publication",
      "version": "2026",
      "retrieved": "2026-11-12T00:38:28Z",
      "attribution": "Trading and clearing holidays from the National Stock Exchange of India, capital market segment."
    },
    "note": "Worked out from the exchange rules in force from 1 September 2025 (NSE Tuesdays, BSE Thursdays; monthly contracts on the month's last one) and the exchange's ho…"
  }
}
```

## Data source

- [Trading and clearing holidays, NSE equities](https://www.nseindia.com/resources/exchange-communication-holidays), 2026, retrieved 2026-11-12T00:38:28Z. Licence: Official publication. Trading and clearing holidays from the National Stock Exchange of India, capital market segment.