Headless Oracle
Headless Oracle
Аттестации состояния рынка, подписанные Ed25519, для 28 мировых бирж.
Что это делает
Автономным торговым агентам необходимо знать, открыта ли биржа, прежде чем совершать сделки. 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 строк). Подпись Ed25519 через @noble/ed25519. Три пространства имен KV (переопределения, ключи API, телеметрия). Два Durable Objects (вебхуки, потоки 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 на каждом ответе. TTL квитанции 60 секунд. Архитектура с отказом в закрытое состояние (UNKNOWN = CLOSED). Заголовки безопасности во всех ответах (HSTS, CSP, X-Content-Type-Options, X-Frame-Options).
См. SECURITY.md для ознакомления с политикой ответственного раскрытия информации.
Документация
Полная документация, организованная по аудитории:
Инженеры: Архитектура, Справочник API, ADR
Операции: Развертывание, Мониторинг, SLA
Юридические вопросы: Условия использования, Политика конфиденциальности, Права на интеллектуальную собственность
Бизнес: Ценообразование, Конкурентный анализ
См. 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