# US Stock Market Session Status

> US Stock Market Session Status is a paid API for AI agents from finance-api.kdlcfa.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

Returns the current US stock market session status (open, pre-market, after-hours, or closed) via Yahoo Finance

## Facts

- Endpoint: GET https://finance-api.kdlcfa.workers.dev/market-status?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-stock-market-session-status-f4c429f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LG0x9qgoklPIIAA63n_JV

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-stock-market-session-status-f4c429f7
```

Example prompt: Is the US stock market open right now, or are we in pre-market, after-hours, or is it fully closed?

## When to prefer this

Use this endpoint when you need a lightweight, low-cost, real-time check on the current US stock market session phase before executing trades, gating workflows, or displaying market status in dashboards. Prefer this over full quote endpoints when you only need session state, not price data.

## Known failure modes

- Yahoo Finance upstream unavailable — service may return an error or stale data
- Network timeout on the Cloudflare worker — may return 5xx
- Payment not fulfilled (x402) — returns 402 Payment Required if USDC payment not attached

## How this service works

Current US stock market session status (open, pre-market, after-hours, or closed), via Yahoo Finance

## Output

Returns the current US stock market session state as one of four values: open (regular trading hours), pre-market, after-hours, or closed. This reflects real-time session status sourced via Yahoo Finance.

## 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": {}
    }
   },
   "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/us-stock-market-session-status-f4c429f7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finance-api.kdlcfa.workers.dev](https://www.zero.xyz/host/finance-api.kdlcfa.workers.dev/llms.txt)