---
title: "Authenticated signed receipt"
method: GET
path: "/v5/status"
tags: ["Market State"]
---

# Authenticated signed receipt

`GET /v5/status`

## Request

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

Returns a signed market-state receipt. Requires X-Oracle-Key header OR x402 payment via Payment-Signature/X-Payment header. Primary production endpoint.

## Query parameters

- `mic` string

## Headers

- `Payment-Signature` string
- `X-Payment` string

## Response `200`

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.

## Other responses

- `400`: Unknown MIC
- `401`: Missing API key
- `402`: Payment required — free tier exhausted or no API key. Body includes x402 payment requirements (accepts[], payTo, amount). Send Payment-Signature or X-Payment header to pay $0.001 USDC per request.
- `403`: Invalid 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)