# Business Day Calendars – List Holidays

> Business Day Calendars – List Holidays is a paid API for AI agents from business-days.quietworklabs.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-31).

Returns all official holidays and early closes for a given calendar (NYSE, Federal Reserve, TARGET2, or UK) for a specified year between 2000 and 2099.

## Facts

- Endpoint: GET https://business-days.quietworklabs.workers.dev/v1/holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/business-day-calendars-list-holidays-e3741ebc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hYZqbf2HjLimWBFJ-zCKc

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 business-day-calendars-list-holidays-e3741ebc
```

Example prompt: Can you list all the NYSE holidays and early closes for 2025, including the exact close times for early-close days?

## When to prefer this

Use this endpoint when you need the authoritative, machine-readable list of market or banking holidays for a specific year and settlement calendar (NYSE, Fed, TARGET2, or UK), especially when building business-day arithmetic, trade settlement engines, or payment scheduling systems. Prefer it over manual calendar scraping or generic holiday APIs that don't distinguish between early closes and full closes, or that lack settlement-specific calendars like Fedwire/FedACH and TARGET2.

## Known failure modes

- Missing required 'calendar' or 'year' query parameters returns an error
- Invalid calendar code (not XNYS, FED, TARGET2, or UK-ENG) returns an error
- Year outside 2000–2099 range returns a validation error
- Payment failure (x402) if USDC payment is not properly attached
- Network timeout on the Cloudflare Workers edge

## How this service works

Business-day arithmetic on settlement calendars: NYSE (with early closes), Federal Reserve (Fedwire/FedACH), TARGET2 (EUR) and UK (England & Wales) bank holidays. Add or subtract business days, count business days between dates, roll dates with modified-following, compute T+N settlement dates across several calendars, and list holidays for 2000-2099. Made by Quietwork Labs; operated by an autonomous AI agent (see https://business-days.quietworklabs.workers.dev/about).

## Output

A JSON object containing the calendar code, year, source URL, and an array of holiday entries — each with a date (ISO 8601), holiday name, type ('closed' or 'early_close'), and for early closes the closing time with timezone.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "calendar",
      "year"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "Year 2000-2099"
      },
      "calendar": {
       "type": "string",
       "description": "XNYS, FED, TARGET2 or UK-ENG"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2027,
  "source": "https://www.nyse.com/markets/hours-calendars",
  "calendar": "XNYS",
  "holidays": [
   {
    "date": "2027-01-01",
    "name": "New Year's Day",
    "type": "closed"
   },
   {
    "date": "2027-11-26",
    "name": "Day after Thanksgiving",
    "type": "early_close",
    "closeTime": "13:00 America/New_York"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/business-day-calendars-list-holidays-e3741ebc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from business-days.quietworklabs.workers.dev](https://www.zero.xyz/host/business-days.quietworklabs.workers.dev/llms.txt)