# India Data Gateway – NSE Market Holidays

> India Data Gateway – NSE Market Holidays is a paid API for AI agents from gateway.hillguava.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns the list of NSE (National Stock Exchange of India) market holidays for a given year and market segment, such as cash equities.

## Facts

- Endpoint: GET https://gateway.hillguava.xyz/holidays/nse
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/india-data-gateway-nse-market-holidays-017992a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yp8wpPdSpSXt65So-UChI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability india-data-gateway-nse-market-holidays-017992a4
```

Example prompt: Can you pull up all the NSE market holidays for 2026 in the cash equities segment so I know which trading days to avoid scheduling my orders on?

## When to prefer this

Use this endpoint when you need official NSE market holiday data for India, especially for automating trading systems, scheduling financial workflows, or validating whether a specific date is a trading day. It requires no API key or account setup and is billed per call in USDC, making it ideal for agents that need occasional or irregular lookups without subscription overhead.

## Known failure modes

- Invalid or unsupported year returns empty holidays array or error
- Unsupported market segment parameter may return unexpected results
- Payment failure via x402/USDC blocks the request before data is returned
- Network timeout from upstream NSE data source

## How this service works

The India data layer for AI agents. Pay only for the calls you make — no API keys, no accounts, no minimums, no rate limits. One x402 origin covering Indian weather (forecasts, monsoon), markets (stocks, indices, F&O with Black-Scholes Greeks, historical, mutual funds), RBI macro, identity/format verification (IFSC, pincode, GSTIN), NSE market holidays, panchang (Hindu almanac), and live cricket scores. Settle per call in USDC on Base.

## Output

Returns a JSON object containing the total count of holidays, the year(s) queried, the market segment (e.g. CM for cash equities), the calendar identifier ('nse'), and an array of holiday objects each with a date (YYYY-MM-DD), weekday name, and description of the holiday (e.g. 'Republic Day').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 20,
  "years": [
   "2026"
  ],
  "segment": "CM (cash equities)",
  "calendar": "nse",
  "holidays": [
   {
    "date": "2026-01-26",
    "weekday": "Monday",
    "description": "Republic Day"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/india-data-gateway-nse-market-holidays-017992a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.hillguava.xyz](https://www.zero.xyz/host/gateway.hillguava.xyz/llms.txt)