---
title: "Real-time halt detection status"
method: GET
path: "/v5/status/realtime"
tags: ["Market State"]
---

# Real-time halt detection status

`GET /v5/status/realtime`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/status/realtime`
- Auth: API key in header `X-Oracle-Key`

Returns the signed receipt plus halt monitor metadata (active REALTIME overrides). Requires X-Oracle-Key.

## Query parameters

- `mic` string

## Response `200`

Receipt with halt monitor metadata

- object
  - `mic` string
  - `signed_receipt` SignedReceipt
    - `receipt_id` string, uuid, required
    - `issued_at` string, date-time, required
    - `expires_at` string, date-time, required: Do not act on this receipt after this time.
    - `issuer` string, required: Domain of the oracle that issued this receipt. Resolve {issuer}/v5/keys to retrieve the public key.
    - `mic` string, required
    - `status` 'OPEN' | 'CLOSED' | 'HALTED' | 'UNKNOWN', required: UNKNOWN MUST be treated as CLOSED. Halt all execution.
    - `source` 'SCHEDULE' | 'OVERRIDE' | 'SYSTEM' | 'REALTIME', required
    - `reason` string: Present when source is OVERRIDE.
    - `halt_detection` 'active' | 'schedule_only', required: "active" = real-time intraday halt detection via external API (XNYS, XNAS only). "schedule_only" = calendar hours + holidays only; unscheduled intraday circuit breaker halts are not detected. Agents must adjust confidence accordingly.
    - `receipt_mode` 'demo' | 'live', required: 'demo' for unauthenticated /v5/demo; 'live' for /v5/status, /v5/batch, and MCP tool receipts.
    - `schema_version` string, required: Receipt schema version. Consumers should verify this matches the version they were built against.
    - `public_key_id` string, required
    - `signature` string, required: Ed25519 signature of canonical payload as 128-char hex string.
  - `halt_monitor` object

## Other responses

- `400`: Unknown MIC
- `401`: Missing API key

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)