# Tokenguard Holidays Lookup

> Tokenguard Holidays Lookup is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns public holidays for a given country and year, including dates, English names, and local-language names

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/data/holidays
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-holidays-lookup-193cea80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AcTnfz-MDjm5aQbM_Yy3t

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 tokenguard-holidays-lookup-193cea80 -d '<json body>'
```

Example prompt: Can you fetch all the public holidays in Japan for 2026, including their local Japanese names?

## When to prefer this

Use this endpoint when you need structured, localized public holiday data for a specific country and year, particularly when you also need the local-language name of each holiday. Prefer this over generic calendar APIs if you are already integrated with the Tokenguard API suite and paying per-call via x402 on Base.

## Known failure modes

- Invalid or unsupported country code returns an error or empty holidays array
- Year out of supported range may return empty results
- Missing required parameters (country or year) return a validation error
- Payment failure via x402 micropayment results in 402 Payment Required response
- Network timeout on Hugging Face Spaces during cold start

## How this service works

Public holidays for a country and year (ISO-2 code) — what a scheduling agent needs before proposing a date

## Output

A JSON object containing the requested country code, year, total count of holidays, and an array of holiday objects each with a date (YYYY-MM-DD), English name, and local-language name.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "integer",
   "description": "Year (default current)"
  },
  "country": {
   "type": "string",
   "description": "ISO-2 country code, e.g. JP"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "count": 2,
  "country": "JP",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "local_name": "元日"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-holidays-lookup-193cea80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)