# Market Hours API – Is Market Open

> Market Hours API – Is Market Open is a paid API for AI agents from market-hours-api.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-28).

Returns whether a specific stock exchange or futures market is currently open (or at a given time), the session type, and the next open/close times in UTC and local time.

## Facts

- Endpoint: GET https://market-hours-api.onrender.com/v1/is-open?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-hours-api-is-market-open-9de5512c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nfgFhDM9VA2FaSWVpdfOU

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-hours-api-is-market-open-9de5512c
```

Example prompt: Is the NYSE (XNYS) open right now, and if not, when does it next open?

## When to prefer this

Use this endpoint when you need a quick real-time or point-in-time check on whether a specific exchange or futures market is open, what trading session is active, and when the next state change occurs. Prefer this over full calendar/schedule endpoints when you only need a binary open/closed answer plus immediate next transition times, not the full schedule of holidays or early closes.

## Known failure modes

- Missing required 'market' query parameter returns a validation error
- Unrecognized market code returns an error or empty result
- Malformed 'at' timestamp (non-ISO 8601) causes a parsing error
- Service unavailable on Render cold start, returning 503 or timeout
- Future dates beyond the exchange calendar data may return incomplete results

## How this service works

Returns whether a stock exchange or futures market is open at a given time, the session type (open, break, closed), and the next open and close times in UTC and local time.

## Output

Returns a JSON object indicating whether the specified market is open, the current session type (e.g. open, break, closed), and the next scheduled open and close times expressed in both UTC and the market's local timezone.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "market"
     ],
     "properties": {
      "at": {
       "type": "string",
       "description": "Optional ISO 8601 time with offset, e.g. 2026-11-27T15:00:00Z. Default: now."
      },
      "market": {
       "type": "string",
       "description": "Market code: XNYS, XNAS, XLON, XETR, XSWX, XTKS, XHKG, XSHG, XASX, CME_EQUITY, EUREX_INDEX"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-hours-api-is-market-open-9de5512c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market-hours-api.onrender.com](https://www.zero.xyz/host/market-hours-api.onrender.com/llms.txt)