Headless Oracle
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
This server cannot be deployed
Maintenance
Related MCP Connectors
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
Agent-native MCP for governed commerce, x402 payments, paid capabilities, and verifiable receipts.
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.
Market data, LLM gateway, ML forecasts, batch+bundle, self-building catalog. USDC via x402 + MPP.
Related MCP Servers
- AlicenseAqualityCmaintenanceEight 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.8120 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.12128 npmMIT
- AlicenseNot gradedqualityBmaintenanceProvides real-time stock quotes and batch market data to AI agents, secured via x402 micropayments on Base Mainnet.MIT
- AlicenseAqualityAmaintenancePay-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.2281MIT