Summary
Returns cryptographically signed market open/close receipts for 28 global exchanges including NYSE, NASDAQ, LSE, and JPX. Each response includes an Ed25519 signature you can verify independently, with a 60-second TTL and fail-closed behavior (unknown states default to closed). Exposes 5 MCP tools and 25+ REST endpoints from a Cloudflare Worker deployed to 300+ edge locations. Handles DST transitions, lunch breaks, and holidays through 2027. Useful when autonomous agents need verifiable market state before executing trades, or when you need a single source of truth for exchange hours without polling multiple vendor APIs or maintaining your own calendar logic.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Headless Oracle
Ed25519-signed market-state attestations for 28 global exchanges.
What It Does
Autonomous trading agents need to know if an exchange is open before executing trades. Headless Oracle answers that question with a cryptographically signed receipt that any agent can verify independently — no trust in the operator required. UNKNOWN states are always treated as CLOSED (fail-closed).
Quick Start
# MCP (Claude Desktop, Cursor, any MCP client)
npx headless-oracle-mcp
# REST API — demo receipt (no auth required)
curl https://headlessoracle.com/v5/demo?mic=XNYS
# Sandbox key (200 calls, 7 days, no card) - POST with an email
curl -X POST https://headlessoracle.com/v5/sandbox \
-H 'Content-Type: application/json' \
-d '{"email":"you@example.com"}'
Architecture
Single TypeScript Cloudflare Worker. Ed25519 signing via @noble/ed25519. Three KV namespaces (overrides, API keys, telemetry). Two Durable Objects (webhooks, SSE streams). Runs on Cloudflare's edge network - no origin server.
4-tier fail-closed: KV override check -> schedule engine -> UNKNOWN fallback -> unsigned critical failure.
See docs/architecture/overview.md for the full architecture.
API
Four MCP tools - get_market_status, get_market_schedule, list_exchanges,
get_payment_options. Receipt verification is REST-only (POST /v5/verify) or
offline with @headlessoracle/verify.
The REST surface is enumerated in the OpenAPI 3.1 spec, which is served live and is the list of record. Full references:
Exchanges
23 traditional markets (XNYS, XNAS, XLON, XJPX, XPAR, XHKG, XSES, XASX, XBOM, XNSE, XSHG, XSHE, XKRX, XJSE, XBSP, XSWX, XMIL, XIST, XSAU, XDFM, XNZE, XHEL, XSTO) plus 5 extended (XCBT, XNYM, XCBO, XCOI, XBIN). DST handled automatically via IANA timezone names. Lunch breaks, half-days, and holidays for 2026-2027.
Testing
npm test # the full unit/integration suite
npm run test:smoke # 11 smoke tests against live production
The passing count is published by the worker itself at
/v5/metrics/public as
tests_passing, and CI fails if that number and the suite disagree. It is not
restated here, because a number in a README is a number nothing checks.
Security
Ed25519 signatures on every response. 60-second receipt TTL. Fail-closed architecture (UNKNOWN = CLOSED). Security headers on all responses (HSTS, CSP, X-Content-Type-Options, X-Frame-Options).
See SECURITY.md for the responsible disclosure policy.
Documentation
Full documentation organized by audience:
- Engineers: Architecture, API Reference, ADRs
- Operations: Deployment, Monitoring, SLA
- Legal: Terms of Service, Privacy Policy, IP Ownership
- Business: Pricing, Competitive Analysis
See docs/README.md for the full index.
License
MIT — see LICENSE
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
