Headless Oracle

针对 28 个全球交易所的 Ed25519 签名市场状态证明。

功能概述

自主交易代理在执行交易前需要确认交易所是否处于开放状态。Headless Oracle 通过经加密签名的收据回答该问题，任何代理均可独立验证——无需信任运营商。UNKNOWN（未知）状态始终被视为 CLOSED（关闭）（故障关闭）。

Related MCP server: Agent Receipts

快速入门

# 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

# Instant sandbox key (200 calls, 7 days, no signup)
curl https://headlessoracle.com/v5/sandbox

架构

单个 TypeScript Cloudflare Worker（约 14,000 行代码）。通过 @noble/ed25519 进行 Ed25519 签名。包含三个 KV 命名空间（覆盖配置、API 密钥、遥测数据）。两个 Durable Objects（Webhooks、SSE 流）。部署在全球 300 多个边缘节点。

4 层故障关闭机制：KV 覆盖检查 -> 调度引擎 -> UNKNOWN 回退 -> 未签名关键故障。

完整架构请参阅 docs/architecture/overview.md。

API

5 个 MCP 工具和 25 个以上的 REST 端点。完整参考：

• REST API 参考

• MCP 参考

• OpenAPI 3.1 规范

交易所

23 个传统市场（XNYS, XNAS, XLON, XJPX, XPAR, XHKG, XSES, XASX, XBOM, XNSE, XSHG, XSHE, XKRX, XJSE, XBSP, XSWX, XMIL, XIST, XSAU, XDFM, XNZE, XHEL, XSTO）以及 5 个扩展市场（XCBT, XNYM, XCBO, XCOI, XBIN）。通过 IANA 时区名称自动处理夏令时。包含 2026-2027 年的午休、半天交易及节假日安排。

测试

npm test # 725+ unit/integration tests
npm run test:smoke # 11 live production smoke tests

安全性

每个响应均包含 Ed25519 签名。60 秒收据 TTL。故障关闭架构（UNKNOWN = CLOSED）。所有响应均包含安全标头（HSTS, CSP, X-Content-Type-Options, X-Frame-Options）。

负责任的披露政策请参阅 SECURITY.md。

文档

按受众组织的完整文档：

• 工程师：架构, API 参考, ADR

• 运维：部署, 监控, SLA

• 法律：服务条款, 隐私政策, 知识产权归属

• 业务：定价, 竞争分析

完整索引请参阅 docs/README.md。

许可

MIT — 详见 LICENSE

Maintenance

Resources

• Remote Server
• GitHub Repository
Need Help?Related Servers