# TickerLayer Market Status

> TickerLayer Market Status is a paid API for AI agents from x402.tickerlayer.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns whether a market, asset class, or symbol is currently open, closed, in pre-market, or post-market, with timezone-aware session phase and reason.

## Facts

- Endpoint: GET https://x402.tickerlayer.com/v1/markets/status?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tickerlayer-market-status-32aec940
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mD_p-qg6L97o2HCGx_lYt

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 tickerlayer-market-status-32aec940
```

Example prompt: Is the US stock market open right now, or is it in pre-market or post-market hours? Check the status for stocks in the US market.

## When to prefer this

Use this endpoint when you need to determine the real-time or point-in-time open/closed/phase status of a financial market, asset class, or specific symbol, especially when timezone-awareness and session phase detail (pre-market, post-market, holiday, early close) are important. Prefer this over generic calendar lookups when you need a definitive is_open boolean and structured phase context for automated trading workflows or UI status displays.

## Known failure modes

- Invalid or unrecognized market code returns an error
- Unrecognized symbol format (missing COUNTRY:SYMBOL prefix for stocks) may return error or empty
- Invalid datetime format for 'at' parameter causes a validation error
- Unsupported asset class value causes rejection
- Network or payment failure (x402) prevents response

## How this service works

Check whether a market, asset class, or symbol is open, closed, in pre-market, or in post-market, with timezone-aware session context.

## Output

Returns a JSON object with the asset class, market identifier, status enum (open/closed/pre_market/post_market/maintenance), is_open boolean, phase (primary/pre_market/post_market/closed/weekend/holiday/early_close/maintenance), a human-readable reason string, current UTC timestamp, the market's timezone, local market time, and metadata including calendar version and optional data notices.

## 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": [],
     "properties": {
      "at": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}T",
       "maxLength": 40,
       "minLength": 20
      },
      "asset": {
       "enum": [
        "stocks",
        "forex",
        "crypto",
        "commodities",
        "indices",
        "etfs",
        "bonds"
       ],
       "type": "string"
      },
      "market": {
       "type": "string",
       "maxLength": 20,
       "minLength": 2
      },
      "symbol": {
       "type": "string",
       "description": "Use COUNTRY_OR_MARKET:SYMBOL for stocks, for example US:AAPL."
      },
      "includeHoliday": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string"
      },
      "includeSessions": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "asset",
      "market",
      "status",
      "is_open",
      "phase",
      "reason",
      "timestamp",
      "timezone",
      "local_time",
      "meta"
     ],
     "properties": {
      "meta": {
       "type": "object",
       "required": [
        "calendar_version"
       ],
       "properties": {
        "data_notice": {
         "type": "string"
        },
        "calendar_version": {
         "type": "string"
        }
       },
       "additionalProperties": true
      },
      "asset": {
       "type": "string"
      },
      "phase": {
       "enum": [
        "primary",
        "pre_market",
        "post_market",
        "closed",
        "weekend",
        "holiday",
        "early_close",
        "maintenance"
       ],
       "type": "string"
      },
      "market": {
       "type": "string"
      },
      "reason": {
       "type": "string"
      },
      "status": {
       "enum": [
        "open",
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tickerlayer-market-status-32aec940/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tickerlayer.com](https://www.zero.xyz/host/x402.tickerlayer.com/llms.txt)