Skip to main content
Glama

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: @getplexa/mcp

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:

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:

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

Licencia

MIT — consulta LICENSE

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    MCP 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.
    8
    23 npm
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    A 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.
    2
    127 npm
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Pay-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.
    12
    47 npm
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Cryptographically 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.
    -