# Delx Holidays

> Delx Holidays is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Returns the list of observed US federal holidays for a given year

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/holidays
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-holidays-03925e5d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HFM8wCezfPKJf1CoK2YfV

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 delx-holidays-03925e5d -d '<json body>'
```

Example prompt: Can you get me the complete list of observed US federal holidays for 2025?

## When to prefer this

Use this endpoint when you need a programmatic, authoritative list of observed US federal holidays for a specific year, especially in scheduling, payroll, or calendar automation workflows. It is ideal for agents that need to avoid scheduling tasks on public holidays or need to enumerate long weekends for a given year.

## Known failure modes

- Invalid or missing year parameter returns an error
- Year out of supported range may return an empty list or error
- Malformed request body results in a 400-level response
- Payment failure via x402 prevents the response from being returned

## How this service works

List observed US federal holidays for a year for $0.002 USDC. Call when you need this bounded result without an API key or subscription. Returns machine-readable JSON via x402 on Base or Solana. Limitation: results cover only the supplied input or one bounded public endpoint at request time; callers must verify before acting.

## Output

A list of US federal holidays for the requested year, including each holiday's name and observed date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-holidays-03925e5d/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)