Headless Oracle
Headless Oracle
针对 28 个全球交易所的 Ed25519 签名市场状态证明。
功能概述
自主交易代理在执行交易前需要确认交易所是否处于开放状态。Headless Oracle 通过经加密签名的收据回答该问题,任何代理均可独立验证——无需信任运营商。UNKNOWN(未知)状态始终被视为 CLOSED(关闭)(故障关闭)。
Related MCP server: @getplexa/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
This server cannot be deployed
Maintenance
Related MCP Connectors
x402 MCP for agents: crypto prices, funding, DeFi yields, Polymarket, Base RPC + MCP security.
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
CrossingKey MCP for agent commerce, x402 payments, deterministic execution, and verifiable receipts.
Cross-asset market data and LLM inference for AI agents. Pay-per-call in USDC via x402.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for pay-per-call DeFi and crypto data via x402 micropayments on Base. 8 endpoints: token prices, TVL, funding rates, token security, gas tracker, whale monitoring, wallet profiling, and yield scanning.823 npmMIT
- AlicenseAqualityBmaintenanceA Model Context Protocol server that gives any MCP client two economic-safety tools: realizable quote and pretrade check, paid per call in USDC with no accounts.2127 npmMIT
- AlicenseAqualityCmaintenancePay-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.1247 npmMIT
- FlicenseNot gradedqualityCmaintenanceCryptographically anchored, tamper-evident evidence receipts for AI agents — verified run receipts, existence-at-time proofs, and cited answers from an anchored public record. Remote MCP with proof-gated settlement; attests existence and integrity, never truth.-