# Headless Oracle Exchange Status Receipt

> Headless Oracle Exchange Status Receipt is a paid API for AI agents from headlessoracle.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Returns a signed (Ed25519) market-state receipt indicating whether a given exchange is OPEN, CLOSED, HALTED, or UNKNOWN, with a 60-second TTL.

## Facts

- Endpoint: GET https://headlessoracle.com/v5/status/x402?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/headless-oracle-exchange-status-receipt-4f2f852a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R2myGfx4a63k5XTnzwnxe

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 headless-oracle-exchange-status-receipt-4f2f852a
```

Example prompt: Can you get me a signed market-status receipt for the NYSE (XNYS) — I need to know if it's currently open, closed, or halted, and I need the cryptographic proof to verify it myself.

## When to prefer this

Use this endpoint when you need a cryptographically verifiable, tamper-proof attestation of a stock exchange's current trading status — especially for automated trading systems, compliance audit trails, or any workflow where a signed proof-of-state is required rather than just an informal status check. Prefer this over unofficial market calendar APIs when you need non-repudiable evidence of market state at a specific moment, or when downstream consumers need to independently verify the receipt's authenticity via Ed25519 signature.

## Known failure modes

- Invalid or unsupported MIC code — the mic query parameter must be one of the 27 enumerated ISO 10383 codes
- Expired receipt — expires_at is 60 seconds after issued_at; consumers must reject receipts past this window
- Signature verification failure — if the Ed25519 signature does not verify against the public key, the receipt must be rejected
- Payment failure — the x402 micropayment of $0.001 USDC must be successfully processed before a receipt is issued
- UNKNOWN status returned — indicates the oracle cannot determine state; must be treated as CLOSED per fail-closed contract
- Network timeout — the real-time endpoint may be unreachable in rare cases

## How this service works

Signed market-state receipt for one exchange. OPEN/CLOSED/HALTED/UNKNOWN - Ed25519 signed, 60s TTL.

## Output

A JSON object containing a signed market-state receipt with fields: receipt_id (UUID), issued_at, expires_at (issued_at + 60s), issuer ('headlessoracle.com'), mic (the requested exchange code), status (OPEN/CLOSED/HALTED/UNKNOWN), source (SCHEDULE/OVERRIDE/SYSTEM/REALTIME), halt_detection data, receipt_mode (demo/live), schema_version, public_key_id, and a 128-hex-character Ed25519 signature over the canonical alphabetical no-whitespace JSON payload. UNKNOWN must be treated as CLOSED (fail-closed contract). Receipts with expires_at in the past must be rejected.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "required": [
      "mic"
     ],
     "properties": {
      "mic": {
       "enum": [
        "XNYS",
        "XNAS",
        "XLON",
        "XJPX",
        "XPAR",
        "XHKG",
        "XSES",
        "XASX",
        "XBOM",
        "XNSE",
        "XSHG",
        "XSHE",
        "XKRX",
        "XJSE",
        "XBSP",
        "XSWX",
        "XMIL",
        "XIST",
        "XSAU",
        "XDFM",
        "XNZE",
        "XHEL",
        "XSTO",
        "XCBT",
        "XNYM",
        "XCBO",
        "XCOI",
        "XBIN"
       ],
       "type": "string",
       "description": "ISO 10383 Market Identifier Code"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "format": {
     "const": "application/json"
    },
    "example": {
     "type": "object",
     "required": [
      "receipt_id",
      "issued_at",
      "expires_at",
      "issuer",
      "mic",
      "status",
      "source",
      "halt_detection",
      "receipt_mode",
      "schema_version",
      "public_key_id",
      "signature"
     ],
     "properties": {
      "mic": {
       "type": "string",
       "description": "ISO 10383 Market Identifier Code"
      },
      "issuer": {
       "const": "headlessoracle.com"
      },
      "source": {
       "enum": [
        "SCHEDULE",
        "OVERRIDE",
        "SYSTEM",
        "REALTIME"
       ]
      },
      "status": {
       "enum": [
        "OPEN",
        "CLOSED",
        "HALTED",
        "UNKNOWN"
       ],
       "description": "UNKNOWN must be treated as CLOSED (fail-closed contract)."
      },
      "coverage": {
       "type": "string",
       "description": "JSON-encoded string inside the signed bytes; JSON.parse it after verifying the signature. Added to the signed payload by commit 19ccb28 (2026-09-07); the example below predates it."
      },
      "issued_at": {
       "type": "string",
       "format": "date-time"
      },
      "si
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/headless-oracle-exchange-status-receipt-4f2f852a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from headlessoracle.com](https://www.zero.xyz/host/headlessoracle.com/llms.txt)