# Market and Holiday Calendar – Next Upcoming Public Holidays

> Market and Holiday Calendar – Next Upcoming Public Holidays is a paid API for AI agents from market-calendar.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Returns the next upcoming public holidays in a given country within the coming year, including the name, date, and days until each holiday.

## Facts

- Endpoint: GET https://market-calendar.x402tookit.com/next-holidays?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-and-holiday-calendar-next-upcoming-public-holidays-845440bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WEfZJXfBMTHd51ryDZ_mK

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 market-and-holiday-calendar-next-upcoming-public-holidays-845440bd
```

Example prompt: What are the next 5 public holidays in France? Show me the name, date, and how many days away each one is.

## When to prefer this

Use this endpoint when you need a quick, forward-looking list of upcoming public holidays for a specific country without specifying a year — ideal for scheduling, planning, or countdown use cases. Prefer this over the full-year holidays endpoint when you only need the next N holidays from today. Choose this over a manual calendar lookup when you need machine-readable output with days-until counts.

## Known failure modes

- Invalid or unsupported 2-letter country code returns an error or empty holidays list
- Limit parameter out of range (below 1 or above 20) may result in a validation error
- No upcoming holidays found within the year window returns an empty array
- Service degraded flag set to true indicates data may be incomplete or sourced from a fallback
- Payment failure (x402) if USDC balance is insufficient

## How this service works

The next upcoming public holidays in a country within the coming year, with days until each.

## Output

Returns a list of upcoming public holidays for the specified country, each with the holiday name, local name, date, number of days until the holiday, whether it is nationwide or regional, and which regions observe it. Also includes metadata such as the data source, as-of date, summary, and any disclaimer or degraded-data flags.

## 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": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "How many, 1 to 20 (default 5)"
      },
      "country": {
       "type": "string",
       "description": "2-letter country code"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "country": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ]
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "asOfDate": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "holidays": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "regions": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": "string"
          }
         },
         "daysUntil": {
          "type": [
           "null",
           "number"
          ]
         },
         "localName": {
          "type": [
           "null",
           "string"
          ]
         },
         "nationwide": {
          "type": [
           "boolean",
           "null"
          ]
         }
        }
       }
      },
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-and-holiday-calendar-next-upcoming-public-holidays-845440bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market-calendar.x402tookit.com](https://www.zero.xyz/host/market-calendar.x402tookit.com/llms.txt)