# TickerLayer Market Sessions

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

Returns timezone-aware trading session windows (pre-market, regular, post-market, etc.) for a given market or symbol on a specific calendar date.

## Facts

- Endpoint: GET https://x402.tickerlayer.com/v1/markets/sessions
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tickerlayer-market-sessions-8b1ceef1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lvJ87kow7vKiYBkn_v2wI

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-sessions-8b1ceef1
```

Example prompt: What are the trading sessions for US:AAPL on 2025-06-10 — I need to know the exact pre-market, regular, and after-hours windows in the correct timezone.

## When to prefer this

Use this endpoint when you need the precise timezone-aware session breakdown (pre-market, regular, post-market, etc.) for a specific date — not just whether a market is currently open. Prefer this over the open/closed status endpoint when you need the full day's session schedule for scheduling algorithms, trade timing, or calendar integrations. This endpoint is best when the date is known in advance and session window details matter.

## Known failure modes

- Invalid date format (must be YYYY-MM-DD) returns a validation error
- Unknown or unsupported market/symbol returns an error or empty result
- Requesting a date far in the future may return incomplete or missing holiday data
- Network or payment authorization failure returns a 402 or 5xx error
- Combining an asset enum with an incompatible symbol format may return no results

## How this service works

Get timezone-aware trading sessions for a market or symbol on a requested calendar date.

## Output

Returns a JSON object containing the market identifier, the requested date, the market's timezone (IANA format), a boolean indicating whether the market is open, holiday details (if any), an array of session objects with session names and time windows, and metadata including the calendar version.

## 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": {
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "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."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "market",
      "date",
      "timezone",
      "is_open",
      "holiday",
      "sessions",
      "meta"
     ],
     "properties": {
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "meta": {
       "type": "object",
       "required": [
        "calendar_version"
       ],
       "properties": {
        "data_notice": {
         "type": "string"
        },
        "calendar_version": {
         "type": "string"
        }
       },
       "additionalProperties": true
      },
      "market": {
       "type": "string"
      },
      "holiday": {
       "type": [
        "object",
        "null"
       ]
      },
      "is_open": {
       "type": "boolean"
      },
      "sessions": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "timezone": {
       "type": "string"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tickerlayer-market-sessions-8b1ceef1/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)