{"uid":"cap_R2myGfx4a63k5XTnzwnxe","slug":"headless-oracle-exchange-status-receipt-4f2f852a","name":"Headless Oracle Exchange Status Receipt","description":"Signed market-state receipt for one exchange. OPEN/CLOSED/HALTED/UNKNOWN - Ed25519 signed, 60s TTL.","url":"https://headlessoracle.com/v5/status/x402?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$","description":"Ed25519 signature over canonical (alphabetical, no-whitespace) JSON of the payload, hex-encoded."},"expires_at":{"type":"string","format":"date-time","description":"issued_at + 60s. Signed into the canonical payload - consumers must reject expired receipts."},"receipt_id":{"type":"string","format":"uuid"},"receipt_mode":{"enum":["demo","live"]},"public_key_id":{"type":"string","description":"Active key ID published at /v5/keys"},"halt_detection":{"enum":["active","schedule_only"]},"schema_version":{"const":"v5.0"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uOHMJc2jV4GnU60fNOx7R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a signed (Ed25519) market-state receipt indicating whether a given exchange is OPEN, CLOSED, HALTED, or UNKNOWN, with a 60-second TTL.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-trade exchange status check","prompt":"Before I submit this order, check if the NASDAQ (XNAS) is currently open for trading and give me a signed receipt I can keep as proof of the market state at the time."},{"title":"Halt detection for automated trading bot","prompt":"My trading bot needs to know if the Tokyo Stock Exchange (XJPX) is currently halted — pull a signed status receipt so the bot can verify it cryptographically before placing any orders."},{"title":"Audit trail for trade compliance","prompt":"I need a tamper-proof, time-stamped record of whether the London Stock Exchange (XLON) was open at this moment — get me a signed market-state receipt for XLON for our compliance log."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T00:34:23.497Z","isFirstParty":false,"canonicalSlug":"headless-oracle-exchange-status-receipt-4f2f852a"}