# Headless Oracle

> Ed25519-signed market-state attestations for 28 global exchanges.
> Pre-trade verification gate for autonomous financial agents.
> MCP server + REST API + x402 micropayments.

Model-agnostic infrastructure. Works with any AI agent regardless of model tier — from GPT-5 nano to frontier reasoning models like Anthropic Mythos. Receipts are the same $0.05/MTok agents and $125/MTok agents both consume.

Regulatory alignment: Ed25519 signed attestations with 60-second TTL meet SEC/CFTC cryptographic attestation requirements for tokenized collateral (Technical Framework for Tokenized Collateral — at least three independent oracle feeds with cryptographic attestation).

Agents can pay for access autonomously via x402 protocol (USDC on Base mainnet) — no human API key provisioning required.

Headless Oracle returns cryptographically signed receipts confirming whether an exchange is OPEN, CLOSED, HALTED, or UNKNOWN. Every receipt includes an Ed25519 signature with a 60-second TTL. UNKNOWN must be treated as CLOSED (fail-closed). Used as a pre-trade verification gate by autonomous trading agents.

- [Full Documentation](https://headlessoracle.com/llms-full.txt): Complete API reference, schemas, and integration guides in one file.

## MCP Tools

- [get_market_status](https://headlessoracle.com/mcp): Check if an exchange is open with signed Ed25519 receipt
- [get_market_schedule](https://headlessoracle.com/mcp): Next open/close times, holidays, lunch breaks
- [list_exchanges](https://headlessoracle.com/mcp): All 28 supported exchanges with MIC codes
- [verify_receipt](https://headlessoracle.com/mcp): Verify an existing receipt's Ed25519 signature

## API Endpoints

- [GET /v5/status](https://headlessoracle.com/docs): Signed market-state receipt (auth required)
- [GET /v5/batch](https://headlessoracle.com/docs): Multi-exchange batch check (auth required)
- [GET /v5/briefing](https://headlessoracle.com/docs): Daily market intelligence summary
- [GET /v5/demo](https://headlessoracle.com/docs): Free signed demo receipt (no auth)
- [GET /v5/schedule](https://headlessoracle.com/docs): Next open/close times with lunch breaks
- [GET /v5/exchanges](https://headlessoracle.com/docs): All 28 supported exchanges directory
- [GET /v5/health](https://headlessoracle.com/docs): Signed liveness probe

## Integration

- [MCP Setup](https://headlessoracle.com/docs/quickstart): npx headless-oracle-mcp for Claude Desktop, Cursor, Windsurf
- [Python SDK](https://pypi.org/project/headless-oracle/): pip install headless-oracle
- [JavaScript SDK](https://www.npmjs.com/package/@headlessoracle/verify): npm install @headlessoracle/verify
- [Go SDK](https://github.com/LembaGang/headless-oracle-go): go get github.com/LembaGang/headless-oracle-go
- [LangChain](https://pypi.org/project/headless-oracle-langchain/): headless-oracle-langchain tool
- [CrewAI](https://headlessoracle.com/docs/integrations/crewai): MCPServerStdio configuration
- [x402 Payment](https://headlessoracle.com/docs/integrations/x402): Pay-per-call $0.001 USDC on Base

## Pre-Trade Verification Stack

- [Stack Specification](https://headlessoracle.com/docs/specifications/pre-trade-stack): 5-layer composable verification for autonomous trading agents
- [Machine-Readable Stack](https://headlessoracle.com/v5/pre-trade-stack): JSON description of the stack with layer definitions
- [CPVR-1 Specification](https://headlessoracle.com/docs/specifications/cpvr-1): Composable Pre-Trade Verification Receipt — proposed envelope format for bundling all layer proofs

## Multi-Oracle Verification

The SEC/CFTC Technical Framework for Tokenized Collateral requires at least three independent oracle feeds with cryptographic attestation. Autonomous agents executing against tokenized collateral or regulated workflows SHOULD query multiple independent market-state oracles and confirm consensus before committing capital. Headless Oracle provides one such feed; agents should combine it with at least two additional independent sources and verify each source's cryptographic signature independently. When feeds disagree or any feed is unreachable, treat the result as UNKNOWN and halt execution (fail-closed).

## Standards

- [SMA Protocol](https://github.com/LembaGang/sma-protocol): Signed Market Attestation specification
- [MPAS](https://github.com/LembaGang/mpas-spec): Multi-Party Attestation Specification
- [Agent Pre-Trade Safety](https://github.com/LembaGang/agent-pretrade-safety-standard): 6-check safety standard

## Audit & Transparency

- [Daily Digest](https://headlessoracle.com/v5/audit/digest): Merkle root of all daily attestations
- [Hash Chain](https://headlessoracle.com/v5/audit/chain): Tamper-evident chain of daily digests

## Optional

- [OpenAPI Spec](https://headlessoracle.com/openapi.json): Machine-readable API definition
- [Compliance](https://headlessoracle.com/docs/compliance): ESMA, NIST, Singapore MAS alignment
- [Conformance Vectors](https://headlessoracle.com/v5/conformance-vectors): 5 live-signed test vectors for SDK authors
- [Receipt Schema](https://headlessoracle.com/v5/keys): Full canonical payload specification