Headless Oracle

io.github.LembaGangv5.0.0更新於 Oct 10, 2026

Ed25519-signed market open/close receipts for NYSE, NASDAQ, LSE, JPX, Euronext, HKEX, and SGX.

已驗證Streamable HTTP可網頁執行Developer ToolsFinance

概覽

AI 產生的概覽

讓助理查詢全球證券交易所目前是開市還是休市，並取得可獨立驗證的簽章市場狀態憑證。

功能
Headless Oracle 回答指定交易所目前處於開市、休市還是未知狀態，涵蓋 23 個傳統市場以及 5 個延伸市場。它提供四個 MCP 工具：get_market_status、get_market_schedule、list_exchanges 和 get_payment_options。每個回應都帶有 Ed25519 簽章，代理可獨立驗證憑證，未知狀態一律視為休市。憑證驗證本身透過 REST 或離線方式完成，而不是透過 MCP 工具。
適用情境
當自動交易或排程代理在執行操作前必須確認交易所的開市/休市狀態，並且希望該結果可被加密驗證而非僅憑信任時，適合使用。它面向需要 2026-2027 年假日、半日市、午休和日光節約時間感知排程的代理。
執行需求
遠端 streamable HTTP 端點；未宣告需要安裝任何套件。README 還展示了 npx 指令和 REST 呼叫，但清單未宣告任何套件、環境變數、標頭或身分驗證。沙箱金鑰需透過提交電子郵件地址申請；付費方案透過 get_payment_options 提及。
安裝前請注意
README 提到透過提交電子郵件地址取得沙箱金鑰，並提及 get_payment_options 工具，因此可能涉及付費使用。憑證有效期為 60 秒，未知狀態會回報為休市，可能阻止交易。MCP 工具本身不提供憑證驗證功能。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Headless Oracle，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "headless-oracle": {
      "type": "http",
      "url": "https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp"
    }
  }
}

README

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

bash
# 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 emailcurl -X POST https://headlessoracle.com/v5/sandbox \  -H 'Content-Type: application/json' \  -d '{"email":"[email protected]"}'

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

bash
npm test              # the full unit/integration suitenpm 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:

See docs/README.md for the full index.

License

MIT — see LICENSE

來源：README.md，提交 3f58128

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v5.0.0最新Sep 16, 2026