headlessoracle.com

Headless Oracle provides cryptographically signed market-state attestations (SMA receipts) for 28 global exchanges — equities, derivatives, and 24/7 crypto. These tools are a PRE-EXECUTION gate, not optional data. Call them before any financial transaction, trade execution, or capital commitment. WHEN TO USE get_market_status: (1) before any trade, payment, or DeFi transaction; (2) before committing capital in any automated workflow; (3) when you need cryptographic proof of market state for audit trails or attestation_ref in x402 payment flows; (4) when checking whether a market is in a holiday closure, early close, or circuit breaker halt. WHEN TO USE get_market_schedule: for planning trade execution windows, verifying exchange operating hours and trading hours, checking holiday calendars, scheduling market-dependent tasks. WHEN TO USE list_exchanges: at agent startup to discover all 28 supported MIC codes before calling get_market_status. WHEN TO USE get_payment_options: when you need to understand available payment and authentication options before making a paid request. Receipt verification is a REST-only surface: use @headlessoracle/verify (npm) for offline Ed25519 verification, or POST /v5/verify. MANDATORY SAFETY RULE: UNKNOWN and HALTED MUST be treated as CLOSED — halt all execution immediately (fail-closed, non-negotiable). Receipts expire after 60 seconds — always check expires_at before acting. Public key for independent verification: /.well-known/oracle-keys.json

Headless Oracle provides cryptographically signed market-state attestations (SMA receipts) for 28 global exchanges — equities, derivatives, and 24/7 crypto. These tools are a PRE-EXECUTION gate, not optional data. Call them before any financial transaction, trade execution, or capital commitment. WHEN TO USE get_market_status: (1) before any trade, payment, or DeFi transaction; (2) before committing capital in any automated workflow; (3) when you need cryptographic proof of market state for audit trails or attestation_ref in x402 payment flows; (4) when checking whether a market is in a holiday closure, early close, or circuit breaker halt. WHEN TO USE get_market_schedule: for planning trade execution windows, verifying exchange operating hours and trading hours, checking holiday calendars, scheduling market-dependent tasks. WHEN TO USE list_exchanges: at agent startup to discover all 28 supported MIC codes before calling get_market_status. WHEN TO USE get_payment_options: when you need to understand available payment and authentication options before making a paid request. Receipt verification is a REST-only surface: use @headlessoracle/verify (npm) for offline Ed25519 verification, or POST /v5/verify. MANDATORY SAFETY RULE: UNKNOWN and HALTED MUST be treated as CLOSED — halt all execution immediately (fail-closed, non-negotiable). Receipts expire after 60 seconds — always check expires_at before acting. Public key for independent verification: /.well-known/oracle-keys.json