Headless Oracle

Аттестации состояния рынка, подписанные Ed25519, для 28 мировых бирж.

Что это делает

Автономным торговым агентам необходимо знать, открыта ли биржа, прежде чем совершать сделки. 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 строк). Подпись Ed25519 через @noble/ed25519. Три пространства имен KV (переопределения, ключи API, телеметрия). Два Durable Objects (вебхуки, потоки SSE). Развернуто в более чем 300 пограничных узлах по всему миру.

4-уровневая система отказа в закрытое состояние: проверка переопределения KV -> движок расписания -> резервный вариант UNKNOWN -> критический сбой без подписи.

См. docs/architecture/overview.md для ознакомления с полной архитектурой.

API

5 инструментов MCP и более 25 REST-эндпоинтов. Полные справочные материалы:

• Справочник REST API

• Справочник MCP

• Спецификация OpenAPI 3.1

Биржи

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