Market State

Public signed receipt

Returns a signed market-state receipt. No authentication required. Suitable for integration testing and public dashboards. For production use, prefer /v5/status.

get/v5/demo

Request

Base URL: https://headlessoracle.com
URL: https://headlessoracle.com/v5/demo
Auth: none declared

Query parameters

micstring

Market Identifier Code (MIC). See /v5/exchanges for supported values.

Response

Signed receipt

receipt_idstring uuid required

issued_atstring date-time required

expires_atstring date-time required

Do not act on this receipt after this time.

issuerstring required

Domain of the oracle that issued this receipt. Resolve {issuer}/v5/keys to retrieve the public key.

micstring required

status'OPEN' | 'CLOSED' | 'HALTED' | 'UNKNOWN' required

UNKNOWN MUST be treated as CLOSED. Halt all execution.

source'SCHEDULE' | 'OVERRIDE' | 'SYSTEM' | 'REALTIME' required

reasonstring

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_versionstring required

Receipt schema version. Consumers should verify this matches the version they were built against.

public_key_idstring required

signaturestring required

Ed25519 signature of canonical payload as 128-char hex string.

Example response

{
  "issuer": "headlessoracle.com",
  "mic": "XNYS",
  "schema_version": "v5.0",
  "public_key_id": "key_2026_v1"
}

Changes

No recorded changes to this operation across all 1 revision of this API.