{"name":"Headless Oracle","version":"v5.0","description":"Autonomous agents execute trades and payments during market closures, circuit breaker halts, and DST transitions without knowing it — this oracle provides cryptographically signed market-state receipts so agents can gate execution on confirmed open markets.","url":"https://headlessoracle.com","provider":{"organization":"LembaGang","url":"https://headlessoracle.com"},"documentationUrl":"https://headlessoracle.com/docs","quickstartUrl":"https://headlessoracle.com/docs/quickstart","capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"authentication":{"schemes":["bearer","apiKey","x402"],"credentials":"https://headlessoracle.com/v5/keys/request"},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"skills":[{"id":"get_market_status","name":"Get Market Status","description":"Pre-trade verification gate: returns Ed25519-signed market-state receipt (OPEN/CLOSED/HALTED/UNKNOWN) for any of 28 global exchanges. Use before any financial execution, capital commitment, or market-dependent workflow. UNKNOWN and HALTED must be treated as CLOSED (fail-closed). Receipt includes attestation_ref (signature) for x402 payment flows and audit trails. 60-second TTL.","tags":["finance","market-data","safety","signed-receipt","fail-closed"],"examples":["Is NYSE open right now?","Verify XLON is trading before executing this payment"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"get_market_schedule","name":"Get Market Schedule","description":"Returns holiday-aware trading session schedule: next open/close UTC times, market hours, trading hours, exchange operating hours, holiday calendar, lunch break windows (XJPX/XHKG/XSHG/XSHE), and session status across 28 exchanges.","tags":["finance","schedule","market-hours"],"examples":["When does Tokyo Stock Exchange open next?","What are XJPX trading hours?"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"list_exchanges","name":"List Exchanges","description":"Returns directory of all 28 supported exchanges with MIC codes, names, IANA timezones, and exchange operating hours metadata. Use at agent startup to discover supported markets before calling get_market_status or get_market_schedule.","tags":["finance","exchange-directory"],"examples":["Which exchanges does this oracle cover?"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"verify_receipt","name":"Verify Receipt Signature","description":"Verifies Ed25519 cryptographic proof on a Signed Market Attestation receipt — confirms genuine pre-trade verification attestation (attestation_ref), receipt authenticity, and signature validity for audit trails and x402 payment flows.","tags":["finance","verification","cryptography","trust"],"examples":["Verify this market receipt before processing the payment"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"get_sandbox_key","name":"Get Sandbox Key","description":"Provision a 7-day API key (200 calls). POST { \"email\": \"you@example.com\" } — email required, one per address.","endpoint":"/v5/sandbox","method":"POST","auth":false,"input":{"email":{"type":"string","required":true,"description":"Email address — key is sent to this address"}},"output":{"type":"object","properties":{"api_key":{"type":"string","description":"Sandbox API key (sb_ prefix)"},"tier":{"type":"string","enum":["sandbox"]},"expires_at":{"type":"string","format":"date-time"},"calls_remaining":{"type":"integer"}}}}],"fail_closed":true,"supported_exchanges":["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"],"input_schema":{"type":"object","properties":{"mic":{"type":"string","description":"ISO 10383 Market Identifier Code","examples":["XNYS","XLON","XJPX"]}},"required":["mic"]},"output_schema":{"type":"object","properties":{"mic":{"type":"string"},"status":{"type":"string","enum":["OPEN","CLOSED","HALTED","UNKNOWN"]},"timestamp":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time","description":"Receipt invalid after this time. Re-fetch required."},"issuer":{"type":"string","example":"headlessoracle.com"},"key_id":{"type":"string","example":"key_2026_v1"},"receipt_mode":{"type":"string","enum":["demo","live"]},"schema_version":{"type":"string","example":"v5.0"},"signature":{"type":"string","description":"Hex-encoded Ed25519 signature over canonical payload (alphabetical key sort, compact JSON)"}},"required":["mic","status","timestamp","expires_at","issuer","key_id","receipt_mode","schema_version","signature"]},"endpoints":{"mcp":"https://headlessoracle.com/mcp","rest":"https://headlessoracle.com/v5/status","oauth":"https://headlessoracle.com/oauth/token","introspect":"https://headlessoracle.com/oauth/introspect","openapi":"https://headlessoracle.com/openapi.json"},"x402_payable":true,"payment":{"schemes":["x402"],"network":"eip155:8453","chain_id":8453,"currency":"USDC","amount_per_request":"0.001 USDC","amount_units":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payment_endpoint":"https://headlessoracle.com/v5/status","subscription_endpoint":"https://headlessoracle.com/v5/checkout","mint_endpoint":"https://headlessoracle.com/v5/x402/mint","discovery":"https://headlessoracle.com/.well-known/x402.json","free_tier_daily_limit":500},"standards":{"sma_version":"1.0","sma_protocol_version":"RFC-001-draft","apts_version":"1.0","sma_spec":"https://github.com/LembaGang/sma-protocol","apts_spec":"https://github.com/LembaGang/agent-pretrade-safety-standard","verifiable_intent_rfc":"https://github.com/agent-intent/verifiable-intent/pulls","conformance_vectors":"https://api.headlessoracle.com/v5/conformance-vectors","mpas_spec":"https://github.com/LembaGang/mpas-spec","mpas_version":"1.0","sma_disambiguation":"SMA denotes Signed Market Attestation, not Simple Moving Average","implementations_registry":"https://headlessoracle.com/v5/implementations"},"dst_aware":true,"discovery_url":"https://headlessoracle.com/.well-known/agent.json","skill_url":"https://headlessoracle.com/skill.md","erc8004":"8453:38413","ampersend":"https://app.ampersend.ai/agents/headless-oracle","mcp":{"endpoint":"https://headlessoracle.com/mcp","protocol_version":"2024-11-05","tools":[{"name":"get_market_status","description":"Pre-trade verification gate: Ed25519-signed market-state receipt (OPEN/CLOSED/HALTED/UNKNOWN) for 28 exchanges. Use before any trade execution, capital commitment, or financial workflow. UNKNOWN/HALTED = CLOSED (fail-closed). Includes attestation_ref for x402 payment flows.","parameters":{"mic":"string (required) — ISO 10383 MIC code, e.g. XNYS"}},{"name":"get_market_schedule","description":"Holiday-aware trading session schedule: next open/close UTC times, market hours, exchange operating hours, holiday calendar, lunch breaks (XJPX/XHKG/XSHG/XSHE), session status for 28 exchanges.","parameters":{"mic":"string (required) — ISO 10383 MIC code"}},{"name":"list_exchanges","description":"Directory of all 28 supported exchanges: MIC codes, names, timezones, exchange operating hours metadata. Call at agent startup to discover all supported MIC codes.","parameters":{}}]},"rest_api":{"base_url":"https://headlessoracle.com","openapi_spec":"https://headlessoracle.com/openapi.json","endpoints":[{"path":"/v5/demo","method":"GET","auth":false,"description":"Public signed receipt"},{"path":"/v5/status","method":"GET","auth":true,"description":"Authenticated signed receipt"},{"path":"/v5/batch","method":"GET","auth":true,"description":"Batch signed receipts for multiple MICs"},{"path":"/v5/schedule","method":"GET","auth":false,"description":"Next open/close times"},{"path":"/v5/exchanges","method":"GET","auth":false,"description":"All supported exchanges"},{"path":"/mics.json","method":"GET","auth":false,"description":"All 28 supported MICs with exchange metadata and ISO 20022 registry links"},{"path":"/v5/archive","method":"GET","auth":false,"description":"Historical receipt archive (Builder+: 30-day; sandbox/free: today only)"},{"path":"/v5/stream","method":"GET","auth":true,"description":"SSE stream of signed market_status events every 30s via StreamCoordinator Durable Object"},{"path":"/v5/conformance-vectors","method":"GET","auth":false,"description":"Live-signed canonical test vectors for SDK authors (5 vectors: XNYS OPEN/CLOSED, XJPX lunch, UNKNOWN, HEALTH OK)"},{"path":"/v5/keys","method":"GET","auth":false,"description":"Public key registry + canonical payload spec"},{"path":"/v5/health","method":"GET","auth":false,"description":"Signed liveness probe"},{"path":"/.well-known/oracle-keys.json","method":"GET","auth":false,"description":"RFC 8615 key discovery"},{"path":"/v5/compliance","method":"GET","auth":false,"description":"APTS compliance self-report — 6 pre-trade safety checks"},{"path":"/v5/metrics","method":"GET","auth":false,"description":"MCP client telemetry — today's request and unique client counts"},{"path":"/v5/dst-risk","method":"GET","auth":false,"description":"DST transition risk — affected European exchanges, error windows, verified XLON schedule"},{"path":"/v5/traction","method":"GET","auth":false,"description":"Live traction metrics — exchanges, uptime, MCP usage, stack positioning"},{"path":"/v5/metrics/public","method":"GET","auth":false,"description":"Social-proof metrics — exchanges, uptime_days, tests_passing, signing_algorithm, x402 stats, MCPScoreboard preflight score"},{"path":"/v5/usage","method":"GET","auth":true,"description":"Per-key usage stats — requests today/month, limits, credits, upgrade info"},{"path":"/v5/changelog","method":"GET","auth":false,"description":"Versioned changelog — entries[], each with date, version, changes[]"},{"path":"/badge/:mic","method":"GET","auth":false,"description":"SVG status badge for README embedding (shields.io style)"}],"auth":{"header":"X-Oracle-Key","missing":401,"invalid":403,"payment_required":402}},"trust":{"algorithm":"Ed25519","key_id_prefix":"03dc2799","key_registry":"https://headlessoracle.com/v5/keys","well_known":"https://headlessoracle.com/.well-known/oracle-keys.json","verify_sdk":"npm:@headlessoracle/verify"},"safety":{"fail_closed":true,"unknown_means":"CLOSED — halt all execution","receipt_ttl_sec":60}}