# MoneyTools Public Holidays API (Taiwan / US)

> MoneyTools Public Holidays API (Taiwan / US) is a paid API for AI agents from tools.moneytools.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-05).

Returns official public holidays, make-up workdays, and supplemental day-off days for Taiwan or the United States for a given year, plus the next upcoming holiday.

## Facts

- Endpoint: GET https://tools.moneytools.dev/v1/holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-05
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/moneytools-public-holidays-api-taiwan-us-c1703129
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hF9dqTgi3GafvxfWkniiR

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 moneytools-public-holidays-api-taiwan-us-c1703129
```

Example prompt: What are all the official public holidays in Taiwan for 2025, including any make-up workdays or supplemental days off?

## When to prefer this

Use this endpoint when you need authoritative, government-sourced holiday data for Taiwan (including 補假 and make-up workday schedules from the official Taiwan government calendar) or US federal holidays with correct observed dates. Prefer this over generic date libraries or scraped sources when accuracy and official sourcing matter, especially for payroll, HR, or compliance use cases. The micro-payment model ($0.001 USDC) makes it accessible without a subscription.

## Known failure modes

- Invalid country code (not TW or US) returns an error
- Invalid or out-of-range year returns an error
- Free tier exhausted (10/day) with no payment method results in HTTP 402 Payment Required
- Network issues on Base blockchain may delay x402 payment confirmation
- Missing required query parameters may return a validation error

## How this service works

Public holidays (Taiwan / US): Official Taiwan government office calendar (holidays, 補假, make-up workdays) or US federal holidays with observed dates, plus the next holiday. Free tier 10/day; then $0.001 via x402 (HTTP 402 + PAYMENT-REQUIRED) or X-API-Key credits. Not charged on failure. $0.001 USDC per call via x402 on Base. Run by MoneyTools.

## Output

A JSON object listing all public holidays (and for Taiwan, 補假 and make-up workdays) for the requested country and year, each with name and date, plus the next upcoming holiday from today. Also includes payment metadata (whether a charge was made, network, amount in USD, transaction hash).

## 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": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "year": {
       "type": "number",
       "examples": [
        "2026"
       ],
       "description": "year"
      },
      "country": {
       "type": "string",
       "examples": [
        "TW"
       ],
       "description": "TW | US"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "properties": {
      "payment": {
       "type": "object",
       "properties": {
        "charged": {
         "type": "boolean"
        },
        "network": {
         "type": "string"
        },
        "amountUsd": {
         "type": "string"
        },
        "transaction": {
         "type": [
          "string",
          "null"
         ]
        }
       }
      },
      "freeTier": {
       "type": "object"
      },
      "_moneytools": {
       "type": "object",
       "description": "optional plan / partner hints"
      }
     },
     "description": "Tool-specific JSON result (see llms.txt / openapi.json). Always includes payment info.",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/moneytools-public-holidays-api-taiwan-us-c1703129/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.moneytools.dev](https://www.zero.xyz/host/tools.moneytools.dev/llms.txt)