# US Market Holiday Check

> US Market Holiday Check is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Checks whether a given YYYY-MM-DD date falls on a known US stock market holiday, returning a boolean flag and the holiday name if applicable.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/us-market-holiday-check
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-market-holiday-check-f9ecd5fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JFnWtLu9giCipbgSjOlHx

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 us-market-holiday-check-f9ecd5fc -d '<json body>'
```

Example prompt: Is July 4, 2025 a US market holiday? I need to know if the stock market will be closed that day before I schedule any trades.

## When to prefer this

Choose this endpoint when you need a fast, offline, deterministic check of whether a specific date is a standard US market holiday — with no API keys, no live market feeds, and minimal cost. It is ideal for scheduling agents, trade automation pipelines, or calendar tools that need to skip holidays. Prefer it over live market-status APIs when you only need known, recurring US holidays and want predictable latency and near-zero cost.

## Known failure modes

- Invalid date format (non-YYYY-MM-DD) may result in an error or unexpected behavior
- Dates outside the known static holiday set (future years not yet defined) may return false negatives
- Does not account for early market closures (e.g. day before Thanksgiving) — only full holidays
- No live market feed integration; may not reflect newly declared emergency market closures

## How this service works

Check if a YYYY-MM-DD is in a static US market holiday set. Call when scheduling around known US market holidays offline. Returns is_holiday and name if known as deterministic JSON for $0.001 USDC via x402 on Base. First-party local math only—no RPC, live market feed, API keys, storage, or mediagen. Advisory only; the caller owns capital, risk, and production controls.

## Output

Returns a deterministic JSON object with an `is_holiday` boolean and, if the date is a recognized US market holiday, the `name` of that holiday (e.g. 'Thanksgiving Day'). Computed locally with no external dependencies.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "YYYY-MM-DD date"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "schema": "delx/util-us-market-holiday-check/v1",
  "is_holiday": true,
  "holiday_name": "New Year"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-market-holiday-check-f9ecd5fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)