Skip to main content
Glama

Headless Oracle

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

功能概述

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

Related MCP server: orchard-data-mcp

快速入门

# 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 端点。完整参考:

交易所

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。

文档

按受众组织的完整文档:

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

许可

MIT — 详见 LICENSE

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Eight crypto and DeFi data tools for AI agents: prices, gas, one ParaSwap route quote, GoPlus token security and top-holder samples, DefiLlama yields, Hyperliquid/dYdX funding, and observed wallet balances. Inspect prices free; pay 0.001–0.008 USDC per call on Base through x402. No API key or subscription.
    8
    120 npm
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Pay-per-call MCP server for market data with USDC micro-payments, featuring unique ML market-regime forecasts, news catalyst radar, and a live-verified algorithmic trading track record.
    12
    128 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Pay-per-call ($0.005-$0.03 USDC) market, on-chain, and prediction-market data API for AI agents and trading bots via x402 — no signup, no API key. Remote MCP server, 28 tools: token security (honeypot/liquidity/counterfeit checks), Hyperliquid oracle-gap risk, kimchi premium, funding APR, DEX slippage, Polymarket arbitrage/liquidity audits, Hyperliquid HIP-4 odds.
    2
    28
    1
    MIT