# tokenguard Public Holiday Lookup

> tokenguard Public Holiday 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-15).

Returns a full year of national and regional public holidays for a given country, including local names and a past/upcoming flag

## Facts

- Endpoint: GET https://eltociear-tokenguard.hf.space/world/holidays
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-public-holiday-lookup-864ae160
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J0q491p6HBZZku5ykV5mJ

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-public-holiday-lookup-864ae160
```

Example prompt: Can you get me all the public holidays in Japan for 2025, including their local names and whether they've already passed or are still coming up?

## When to prefer this

Choose this endpoint when you need a comprehensive, structured list of holidays for a specific country and year, especially when you need local-language holiday names, regional holidays alongside national ones, and a past/upcoming classification that goes beyond what a static calendar library can provide. Ideal for scheduling, payroll, travel planning, or compliance use cases where accurate, up-to-date holiday data per country is essential.

## Known failure modes

- Invalid or unsupported ISO country code returns an error or empty result
- Year parameter out of supported range may return an error
- Network or payment failure (x402 micropayment not processed) results in 402 or timeout
- Some countries may have incomplete regional holiday coverage

## How this service works

Which days are public holidays in this country? Full year of national and regional holidays with local names and a past/upcoming flag — date arithmetic an agent cannot infer from a calendar alone

## Output

A structured list of public holidays for the specified country and year, each entry containing the date, the holiday's local name, whether it is a national or regional holiday, and a flag indicating whether the holiday is in the past or upcoming relative to today.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "integer",
   "description": "Calendar year (defaults to the current one)"
  },
  "country": {
   "type": "string",
   "description": "ISO 2-letter country code, e.g. JP"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-public-holiday-lookup-864ae160/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)