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: Agent Receipts

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/sandbox

Architektur

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:

• REST-API-Referenz

• MCP-Referenz

• OpenAPI 3.1 Spezifikation

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 tests

Sicherheit

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

Maintenance

Resources

• Remote Server
• GitHub Repository
Need Help?Related Servers