Headless Oracle

28개 글로벌 거래소에 대한 Ed25519 서명 시장 상태 증명.

기능

자율 거래 에이전트는 거래를 실행하기 전에 거래소가 열려 있는지 확인해야 합니다. Headless Oracle은 운영자를 신뢰할 필요 없이 모든 에이전트가 독립적으로 검증할 수 있는 암호학적으로 서명된 영수증을 통해 이 질문에 답합니다. UNKNOWN 상태는 항상 CLOSED(fail-closed)로 처리됩니다.

Related MCP server: Agent Receipts

빠른 시작

# 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 라인). @noble/ed25519를 통한 Ed25519 서명. 3개의 KV 네임스페이스(재정의, API 키, 원격 측정). 2개의 Durable Objects(웹훅, SSE 스트림). 전 세계 300개 이상의 엣지 위치에 배포됨.

4단계 fail-closed: 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 시간대 이름을 통해 일광 절약 시간(DST)이 자동으로 처리됩니다. 2026-2027년 점심 시간, 반일 거래 및 공휴일 포함.

테스트

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

보안

모든 응답에 Ed25519 서명 적용. 60초 영수증 TTL. Fail-closed 아키텍처(UNKNOWN = CLOSED). 모든 응답에 보안 헤더 적용(HSTS, CSP, X-Content-Type-Options, X-Frame-Options).

책임 있는 공개 정책은 SECURITY.md를 참조하십시오.

문서

대상별로 구성된 전체 문서:

• 엔지니어: 아키텍처, API 참조, ADR

• 운영: 배포, 모니터링, SLA

• 법률: 서비스 약관, 개인정보 처리방침, IP 소유권

• 비즈니스: 가격 책정, 경쟁 분석

전체 색인은 docs/README.md를 참조하십시오.

라이선스

MIT — LICENSE 참조

Maintenance

Resources

• Remote Server
• GitHub Repository
Need Help?Related Servers