{
  "markdown": "# Headless Oracle\n\nEd25519-signed market-state attestations for 28 global exchanges.\n\n## What It Does\n\nAutonomous 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).\n\n## Quick Start\n\n```bash\n# MCP (Claude Desktop, Cursor, any MCP client)\nnpx headless-oracle-mcp\n\n# REST API — demo receipt (no auth required)\ncurl https://headlessoracle.com/v5/demo?mic=XNYS\n\n# Instant sandbox key (200 calls, 7 days, no signup)\ncurl https://headlessoracle.com/v5/sandbox\n```\n\n## Architecture\n\nSingle TypeScript Cloudflare Worker (~14,000 lines). Ed25519 signing via `@noble/ed25519`. Three KV namespaces (overrides, API keys, telemetry). Two Durable Objects (webhooks, SSE streams). Deployed to 300+ edge locations globally.\n\n4-tier fail-closed: KV override check -> schedule engine -> UNKNOWN fallback -> unsigned critical failure.\n\nSee [docs/architecture/overview.md](docs/architecture/overview.md) for the full architecture.\n\n## API\n\n5 MCP tools and 25+ REST endpoints. Full references:\n- [REST API Reference](docs/api/rest-reference.md)\n- [MCP Reference](docs/api/mcp-reference.md)\n- [OpenAPI 3.1 Spec](https://headlessoracle.com/openapi.json)\n\n## Exchanges\n\n23 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.\n\n## Testing\n\n```bash\nnpm test              # 725+ unit/integration tests\nnpm run test:smoke    # 11 live production smoke tests\n```\n\n## Security\n\nEd25519 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).\n\nSee [SECURITY.md](SECURITY.md) for the responsible disclosure policy.\n\n## Documentation\n\nFull documentation organized by audience:\n\n- **Engineers**: [Architecture](docs/architecture/overview.md), [API Reference](docs/api/), [ADRs](docs/architecture/adr/)\n- **Operations**: [Deployment](docs/operations/deployment.md), [Monitoring](docs/operations/monitoring.md), [SLA](docs/operations/sla.md)\n- **Legal**: [Terms of Service](docs/legal/terms-of-service.md), [Privacy Policy](docs/legal/privacy-policy.md), [IP Ownership](docs/legal/ip-ownership.md)\n- **Business**: [Pricing](docs/business/pricing-strategy.md), [Competitive Analysis](docs/business/competitive-analysis.md)\n\nSee [docs/README.md](docs/README.md) for the full index.\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n",
  "bytes": 2812,
  "sha": "032221f0962a582090abef93de660c30b5839b434f3b51f2ec35895aad71922a",
  "repo_slug": "lembagang/headless-oracle-v5",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lembagang_headless_oracle_mcp_91c755d0/readme"
}