Headless Oracle

Certificaciones del estado del mercado firmadas con Ed25519 para 28 bolsas globales.

Qué hace

Los agentes de trading autónomos necesitan saber si una bolsa está abierta antes de ejecutar operaciones. Headless Oracle responde a esa pregunta con un recibo firmado criptográficamente que cualquier agente puede verificar de forma independiente; no se requiere confianza en el operador. Los estados UNKNOWN siempre se tratan como CLOSED (fail-closed).

Related MCP server: Agent Receipts

Inicio rápido

# 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

Arquitectura

Un único Cloudflare Worker en TypeScript (~14.000 líneas). Firma Ed25519 mediante @noble/ed25519. Tres espacios de nombres KV (anulaciones, claves API, telemetría). Dos Durable Objects (webhooks, flujos SSE). Desplegado en más de 300 ubicaciones de borde a nivel mundial.

Fail-closed de 4 niveles: comprobación de anulación KV -> motor de programación -> respaldo UNKNOWN -> fallo crítico sin firma.

Consulta docs/architecture/overview.md para ver la arquitectura completa.

API

5 herramientas MCP y más de 25 endpoints REST. Referencias completas:

• Referencia de la API REST

• Referencia MCP

• Especificación OpenAPI 3.1

Bolsas

23 mercados tradicionales (XNYS, XNAS, XLON, XJPX, XPAR, XHKG, XSES, XASX, XBOM, XNSE, XSHG, XSHE, XKRX, XJSE, XBSP, XSWX, XMIL, XIST, XSAU, XDFM, XNZE, XHEL, XSTO) más 5 extendidos (XCBT, XNYM, XCBO, XCOI, XBIN). El horario de verano (DST) se gestiona automáticamente mediante nombres de zona horaria IANA. Pausas para el almuerzo, medias jornadas y días festivos para 2026-2027.

Pruebas

npm test # 725+ unit/integration tests
npm run test:smoke # 11 live production smoke tests

Seguridad

Firmas Ed25519 en cada respuesta. TTL de recibo de 60 segundos. Arquitectura fail-closed (UNKNOWN = CLOSED). Cabeceras de seguridad en todas las respuestas (HSTS, CSP, X-Content-Type-Options, X-Frame-Options).

Consulta SECURITY.md para conocer la política de divulgación responsable.

Documentación

Documentación completa organizada por audiencia:

• Ingenieros: Arquitectura, Referencia de la API, ADRs

• Operaciones: Despliegue, Monitorización, SLA

• Legal: Términos de servicio, Política de privacidad, Propiedad intelectual

• Negocio: Precios, Análisis competitivo

Consulta docs/README.md para ver el índice completo.

Licencia

MIT — consulta LICENSE

Maintenance

Resources

• Remote Server
• GitHub Repository
Need Help?Related Servers