Market State

Authenticated signed receipt

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

get/v5/status

Request

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

Query parameters

micstring

Market Identifier Code (MIC).

Headers

Payment-Signaturestring

x402 v2 payment header — base64-encoded JSON PaymentPayload with EIP-712 TransferWithAuthorization signature. Alternative to X-Oracle-Key for keyless per-request payment ($0.001 USDC on Base mainnet).

X-Paymentstring

x402 v1 payment header — base64-encoded JSON OR raw JSON { txHash, network, amount, paymentAddress, memo }. Alternative to Payment-Signature.

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.