# Market and Holiday Calendar – US Trading Days Between Dates

> Market and Holiday Calendar – US Trading Days Between Dates 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).

Counts the number of US stock market trading days between two dates (inclusive), excluding weekends and NYSE holidays, and lists the holidays encountered.

## Facts

- Endpoint: GET https://market-calendar.x402tookit.com/trading-days-between?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-us-trading-days-between-dates-c7ab894a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IlWg8ZlMq8wN9J2yg5RpL

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-us-trading-days-between-dates-c7ab894a
```

Example prompt: How many US stock market trading days are there between January 2, 2025 and March 31, 2025, and which NYSE holidays fall in that range?

## When to prefer this

Use this endpoint when you need an exact count of US equity market trading days (NYSE) between two calendar dates, with weekends and official NYSE holidays already removed. Prefer it over generic business-day calculators when NYSE holiday accuracy matters — e.g. for options settlement, trade settlement windows, performance period reporting, or any financial calculation tied to market open days.

## Known failure modes

- Missing or malformed 'from' or 'to' query parameters returns an error
- Dates in wrong format (not YYYY-MM-DD) cause a parsing failure
- End date before start date may return zero or an error
- Far-future dates may return degraded results if NYSE holiday schedule is not yet published
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Count US trading days between two dates (inclusive), with weekends and NYSE holidays removed and the holidays listed.

## Output

Returns a count of trading days, weekend days, and calendar days between the two input dates, along with a list of NYSE holidays (name and date) that fell within the range, and metadata fields such as source, disclaimer, and a degraded-data flag if the calendar data is incomplete.

## 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": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "End date YYYY-MM-DD"
      },
      "from": {
       "type": "string",
       "description": "Start date YYYY-MM-DD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "to": {
       "type": [
        "null",
        "string"
       ]
      },
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "from": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "holidays": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "name": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "tradingDays": {
       "type": [
        "null",
        "number"
       ]
      },
      "weekendDays": {
       "type": [
        "null",
        "number"
       ]
      },
      "calendarDays": {
       "type": [
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-and-holiday-calendar-us-trading-days-between-dates-c7ab894a/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)
