Headless Oracle
Headless Oracle
Ed25519-signierte Marktstatus-Attestierungen für 28 globale Börsen.
Was es tut
Autonome Handelsagenten müssen wissen, ob eine Börse geöffnet ist, bevor sie Trades ausführen. Headless Oracle beantwortet diese Frage mit einem kryptographisch signierten Beleg, den jeder Agent unabhängig verifizieren kann – kein Vertrauen in den Betreiber erforderlich. UNKNOWN-Zustände werden immer als CLOSED behandelt (Fail-Closed).
Related MCP server: @getplexa/mcp
Schnellstart
# 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/sandboxArchitektur
Einzelner TypeScript Cloudflare Worker (~14.000 Zeilen). Ed25519-Signierung via @noble/ed25519. Drei KV-Namespaces (Overrides, API-Schlüssel, Telemetrie). Zwei Durable Objects (Webhooks, SSE-Streams). Bereitgestellt an über 300 Edge-Standorten weltweit.
4-stufiges Fail-Closed-System: KV-Override-Prüfung -> Schedule-Engine -> UNKNOWN-Fallback -> unsignierter kritischer Fehler.
Siehe docs/architecture/overview.md für die vollständige Architektur.
API
5 MCP-Tools und über 25 REST-Endpunkte. Vollständige Referenzen:
Börsen
23 traditionelle Märkte (XNYS, XNAS, XLON, XJPX, XPAR, XHKG, XSES, XASX, XBOM, XNSE, XSHG, XSHE, XKRX, XJSE, XBSP, XSWX, XMIL, XIST, XSAU, XDFM, XNZE, XHEL, XSTO) plus 5 erweiterte (XCBT, XNYM, XCBO, XCOI, XBIN). Sommerzeit (DST) wird automatisch über IANA-Zeitzonennamen gehandhabt. Mittagspausen, halbe Handelstage und Feiertage für 2026-2027.
Testen
npm test # 725+ unit/integration tests
npm run test:smoke # 11 live production smoke testsSicherheit
Ed25519-Signaturen auf jede Antwort. 60-Sekunden-Beleg-TTL. Fail-Closed-Architektur (UNKNOWN = CLOSED). Sicherheits-Header auf allen Antworten (HSTS, CSP, X-Content-Type-Options, X-Frame-Options).
Siehe SECURITY.md für die Richtlinie zur verantwortungsvollen Offenlegung.
Dokumentation
Vollständige Dokumentation, organisiert nach Zielgruppe:
Ingenieure: Architektur, API-Referenz, ADRs
Betrieb: Bereitstellung, Überwachung, SLA
Rechtliches: Nutzungsbedingungen, Datenschutzrichtlinie, IP-Eigentum
Geschäft: Preisgestaltung, Wettbewerbsanalyse
Siehe docs/README.md für den vollständigen Index.
Lizenz
MIT — siehe LICENSE
This server cannot be deployed
Maintenance
Related MCP Connectors
x402 MCP for agents: crypto prices, funding, DeFi yields, Polymarket, Base RPC + MCP security.
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
CrossingKey MCP for agent commerce, x402 payments, deterministic execution, and verifiable receipts.
Cross-asset market data and LLM inference for AI agents. Pay-per-call in USDC via x402.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP 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.823 npmMIT
- AlicenseAqualityBmaintenanceA 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.2127 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.1247 npmMIT
- FlicenseNot gradedqualityCmaintenanceCryptographically 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.-