> For the complete documentation index, see [llms.txt](https://docs.openalgo.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openalgo.in/api-documentation/v1/utilities-api/timings.md).

# Timings

Get market trading timings for a specific date across all exchanges.

## Endpoint URL

```http
Local Host   :  POST http://127.0.0.1:5000/api/v1/market/timings
Ngrok Domain :  POST https://<your-ngrok-domain>.ngrok-free.app/api/v1/market/timings
Custom Domain:  POST https://<your-custom-domain>/api/v1/market/timings
```

## Sample API Request

```json
{
  "apikey": "<your_app_apikey>",
  "date": "2025-12-19"
}
```

## Sample cURL Request

```bash
curl -X POST http://127.0.0.1:5000/api/v1/market/timings \
  -H 'Content-Type: application/json' \
  -d '{
  "apikey": "<your_app_apikey>",
  "date": "2025-12-19"
}'
```

## Sample API Response

```json
{
  "status": "success",
  "data": [
    {
      "exchange": "NSE",
      "start_time": 1766115900000,
      "end_time": 1766138400000
    },
    {
      "exchange": "BSE",
      "start_time": 1766115900000,
      "end_time": 1766138400000
    },
    {
      "exchange": "NFO",
      "start_time": 1766115900000,
      "end_time": 1766139000000
    },
    {
      "exchange": "BFO",
      "start_time": 1766115900000,
      "end_time": 1766139000000
    },
    {
      "exchange": "MCX",
      "start_time": 1766115000000,
      "end_time": 1766168700000
    },
    {
      "exchange": "BCD",
      "start_time": 1766115000000,
      "end_time": 1766143800000
    },
    {
      "exchange": "CDS",
      "start_time": 1766115000000,
      "end_time": 1766143800000
    },
    {
      "exchange": "NCO",
      "start_time": 1766115000000,
      "end_time": 1766168700000
    },
    {
      "exchange": "CRYPTO",
      "start_time": 1766082600000,
      "end_time": 1766168999000
    }
  ]
}
```

## Request Body

| Parameter | Description               | Mandatory/Optional | Default Value |
| --------- | ------------------------- | ------------------ | ------------- |
| apikey    | Your OpenAlgo API key     | Mandatory          | -             |
| date      | Date in YYYY-MM-DD format | Mandatory          | -             |

`MarketTimingsSchema` declares only these two fields and both are required. Any other field, including an `exchange` filter, returns HTTP 400: the response always covers every tracked exchange.

## Response Fields

| Field  | Type   | Description             |
| ------ | ------ | ----------------------- |
| status | string | "success" or "error"    |
| data   | array  | Array of timing objects |

### Timing Object Fields

| Field       | Type   | Description                            |
| ----------- | ------ | -------------------------------------- |
| exchange    | string | Exchange code                          |
| start\_time | number | Market open time (epoch milliseconds)  |
| end\_time   | number | Market close time (epoch milliseconds) |

## Default Trading Hours (IST)

These are the shipped defaults. An operator can override any of them from the admin market-timings page, and the API then returns the stored values instead, so read the response rather than assuming this table.

| Exchange | Open  | Close    |
| -------- | ----- | -------- |
| NSE      | 09:15 | 15:30    |
| BSE      | 09:15 | 15:30    |
| NFO      | 09:15 | 15:40    |
| BFO      | 09:15 | 15:40    |
| CDS      | 09:00 | 17:00    |
| BCD      | 09:00 | 17:00    |
| MCX      | 09:00 | 23:55    |
| NCO      | 09:00 | 23:55    |
| CRYPTO   | 00:00 | 23:59:59 |

NFO and BFO close at 15:40, not 15:30. SEBI's Closing Auction Session applies to the equity cash segment only, so the derivatives segment keeps trading past the cash close and the F\&O window is deliberately wider.

## Notes

* Date must be between **2020-01-01 and 2050-12-31**
* Times are returned as **epoch milliseconds**
* On weekends the response is **not** empty: it contains the `CRYPTO` session only, since crypto trades 24/7. A full trading holiday with every exchange closed does return an empty array.
* For **special sessions** (e.g., Muhurat trading), returns only the special session timings
* On a `SETTLEMENT_HOLIDAY` the normal timings for all exchanges are returned, because trading is open
* MCX and NCO have extended trading hours into the night

## Converting Epoch to Readable Time

**JavaScript:**

```javascript
const date = new Date(1766115900000);
console.log(date.toLocaleString('en-IN', { timeZone: 'Asia/Kolkata' }));
// Output: "19/12/2025, 9:15:00 am"
```

**Python:**

```python
from datetime import datetime
import pytz

ist = pytz.timezone('Asia/Kolkata')
dt = datetime.fromtimestamp(1766115900000/1000, ist)
print(dt.strftime('%Y-%m-%d %H:%M:%S %Z'))
# Output: 2025-12-19 09:15:00 IST
```

***

**Back to**: [API Documentation](/api-documentation/v1.md)