# US Market Hours Status

> US Market Hours Status is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns current NYSE/Nasdaq market open/closed status, close reason, New York time, next open/close times, and upcoming market holidays for a given datetime.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/us-market-hours?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-market-hours-status-e4af6122
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SHALa-p2CtuDX4eztpBLM

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 us-market-hours-status-e4af6122 -d '<json body>'
```

Example prompt: Is the US stock market open right now, and if not, when does it next open and how many hours away is that?

## When to prefer this

Use this endpoint when an agent needs a real-time or point-in-time check of US stock market hours (NYSE/Nasdaq), including holiday awareness and countdown-to-open, especially in a pay-per-call x402 USDC context without the overhead of managing a full market data subscription.

## Known failure modes

- Invalid ISO 8601 datetime format returns a validation error
- Malformed request body may return a 400 error
- Temporary service unavailability returns a 5xx error

## How this service works

232 pay-per-call data APIs for AI agents: official statistics and economy (ECB, Fed, Eurostat, World Bank, SEC, BOE, INE), crypto prices and sentiment, Spanish public data, compliance (sanctions, VAT, IBAN, LEI), science, weather, web and developer tools and local AI text tools. Pay in USDC via x402.

## Output

A JSON object with the current market status (open/closed), the reason if closed (e.g. weekend, holiday), the current time in UTC and New York, the next open and close times in UTC, hours until open, and a list of upcoming NYSE/Nasdaq holidays with dates and names.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "datetime": {
   "type": "string",
   "description": "Optional ISO 8601 time to evaluate (default now), e.g. 2026-10-05T14:00:00Z"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "NYSE/Nasdaq hours (regular session 9:30-16:00 New York time). Tokenized stocks can trad…",
  "status": "closed",
  "time_utc": "2026-09-28T00:58:24Z",
  "close_reason": "weekend",
  "new_york_time": "2026-09-27 20:58 EDT",
  "next_holidays": [
   {
    "date": "2026-11-26",
    "name": "Thanksgiving Day"
   }
  ],
  "next_open_utc": "2026-09-28T13:30:00Z",
  "next_close_utc": "2026-09-28T20:00:00Z",
  "hours_until_open": 12.53,
  "regular_session_today": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-market-hours-status-e4af6122/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)