# Market and Holiday Calendar – Long Weekends

> Market and Holiday Calendar – Long Weekends 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-29).

Returns all long weekends in a given year for a specified country, including their start/end dates, total days, and any bridge days that could extend them.

## Facts

- Endpoint: GET https://market-calendar.x402tookit.com/long-weekends?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-and-holiday-calendar-long-weekends-0d4adfe8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EMEWp4-ar9sLRR9Qojvbr

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-long-weekends-0d4adfe8
```

Example prompt: What are all the long weekends in France for 2025, including any bridge days that could make them even longer?

## When to prefer this

Use this endpoint when you need a complete list of long weekends for an entire year in a specific country, especially when bridge day information is important for vacation or workforce planning. Prefer this over general public holiday endpoints when the user is focused on extended breaks rather than individual holidays. Supports approximately 100 countries.

## Known failure modes

- Invalid or unsupported 2-letter country code returns an error or empty result
- Year outside the 1990–2100 range returns a validation error
- Missing required query parameters (country or year) returns a 400-level error
- Degraded mode may return partial or unverified data, flagged via the 'degraded' field

## How this service works

Long weekends in a year for a country, with length in days and the bridge days that would extend them.

## Output

Returns an array of long weekends for the specified country and year, each with a start date, end date, total number of days, a list of bridge days (dates that if taken off would extend the weekend), and a flag indicating whether a bridge day is needed to achieve the extension. Also includes metadata like data source URL, as-of date, and any disclaimer.

## 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",
      "year"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "description": "Year, 1990 to 2100"
      },
      "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"
       ]
      },
      "year": {
       "type": [
        "null",
        "number"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "country": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "longWeekends": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "end": {
          "type": [
           "null",
           "string"
          ]
         },
         "days": {
          "type": [
           "null",
           "number"
          ]
         },
         "start": {
          "type": [
           "null",
           "string"
          ]
         },
         "bridgeDays": {
          "type": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-and-holiday-calendar-long-weekends-0d4adfe8/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)